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Web Trees & Menus LOADED with NEW Features! 
IMPROVED Help for Win Controls & Web Grid! 



Grids - Learn one, know them all! 

■ Intuitive Common Object Model for COM, .NET and 
ASP.NET grids 

■ Sophisticated handling and rendering of hierarchical data 
for maximum visual appeal 

Toolbars, Trees, Menus, Listbars, Tabs, 
Dockable Windows and Web Navigation 

■ Visual Studio. NET-style dockable windows with tab-style 
group of docked windows 

■ NEW Web trees & menus, with new client-side object 
model, APIs & events, and LOADED with new features, 
for virtually same look and feel of client-side controls 

■ Toolbars, menus and trees - with XP Look & Feel 

Scheduling - Advanced flexibility! 

■ Deliver the look, feel and functionality 

of Outlook's calendaring and scheduling functions 

■ Synchronize data, appearances and control behavior 
seamlessly across scheduling controls (.NET) 

Charting - We've made it so easy! 

■ Common Object Model - as simple as copying code from 
.NET to ASP.NET 

■ ASP.NET server-side charting looks and acts like a client 
side control with incredibly rich client-side interactivity, 
yet features our exclusive built-in security 

Editors - An amazing selection! 

■ Stand-alone or embeddable editors include MaskEdit, 
Text, Combo, DateTime, Currency, Numeric, Check, 
OptionSet, FontName, ColorPicker, Calculator, 
ProgressBar and CalendarCombo 

Ul Components 

■ A huge collection of GUI components in COM & .NET 



NetAdvantage Suite 2.1 

■ All source code for our .NET designers and components 
(subscription and enterprise editions only) 

■ Our ASP.NET components deliver thin client deployment 
with rich client interfaces 

■ Licensed per developer (multiple installs for non- 
concurrent use). No runtime or server deployment charges 

■ RAD designers maximize productivity, minimize code 

■ XP Look & Feel and XP Theme Support" 

■ Advanced architecture such as our exclusive Presentation 
Layer Framework™ 

■ The biggest selection of presentation layer controls for any 
Microsoft platform available in one suite. 

Over 75 best of breed components in all! 

.NET Source Code is included in the NetAdvantage Suite with 
subscription or Enterprise Edition! 
Source code not available for COM controls 

Download a free, full-featured trial version! 
Order online, or contact us! 

www.infragistics.com 
800-231-8588 



See us at VSLive! 

San Francisco 
February 9-14, 2003 



infragjstics.com/nelaclvantag* 
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An entire framework of presentation layer 
components for COM, .NET & ASP.NET 
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NetAd vantage Suite 2.1 

includes COM, .NET & ASP.NET $495 

with annual subscription 

a year's worth of updates, 

upgrades and new products 

■* includes .NET source code $695 

Enterprise Edition 

product, subscription as well 

as guaranteed priority support 

■» includes .NET source code $995 
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I nstal IShield has always been your Windows installation solution. And now that you want your 
setups to use the database structure of the Windows Installer service (MSI) instead of being fully 
script-based, InstallShield still has you covered. Instal IShield Developer™ provides unparalleled 
support for Windows Installer and even extends the architecture by including scripting capabilities. 
InstaliScript™, VBScript, and JScript can all be leveraged to meet your unique setup requirements. 
So don't worry about your installations. Now, as always, your setups evolve with InstallShield. 



Featuring 




VisualStudio.net 

Technology 



Microsoft 

CERTIFIED 



Partner 



► Unparalleled Windows Installer (MSI) Support 

► Extensions to MSI via Script 

► MSI Debugger 

► Direct MSI Table Editor 

► Merge Module and Transform Project Types 

► MSI 2.0 and 1.2 Engine Distribution 



InstallShield Developer 
is Your Windows Installer 
Setup Solution. 



© 2002 InstallShield Software Corporation. All rights reserved. 
Trademarks are the property of their respective owners. 
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Leverage VB.NET's Object-Oriented 
Features 

Visual Basic .NET has joined the ranks of full-blown 
object-oriented programming languages. Improve 
your code's flexibility and maintainability through 
inheritance, constructors, method overriding, and 
other OOP features. 

by Francesco Balena 
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As String 



(:)□ Class Customer 

Inherits Person 

Public Title A3 String 

Overrides Function CompleteName () As String 
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Getting Started 

Type Your Data Wisely 

Efficient .NET programming requires a sound understanding 
of how data types function. This overview helps you select the 
right data types for your application's variables. 

by Kathleen Oollard 
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Desktop Developer 

Develop Composite Controls 

Learn a great way to enhance user inrerfaces in .NET 
WinForms applications by building a powerful composite 
control that implements a group of collapsible panels, 
by Douglas Gennetten and Jonathan Lurie 
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Q&A 

Call WinForms on Multiple Threads 

Find out how to use the ISynchronizelnvoke interface to call 
message-handling methods from multiple threads, and how to 
make HTML on the clipboard recognizable to other apps. 

by Juval Lowy and Karl E. Peterson 
www.visualstudiomagazine.com 

To subscribe: 866-387-8275 (domestic), 
850-682-7652 (international), or 800-456-5911 



Visual Studio Magazine (ISSN: 1537 002X; Canadian GST: 86831-0764) is 
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the basic annual subscription rate of $34.97. Periodicals Postage Paid at Palo 
Alto, CAand additional mailing offices. Canadian Publication Mail Agreement 
# 358177. POSTMASTER: Send address changes to Visual Studio Magazine, 
P.O. Box 58872, Boulder, CO 80322-8872. 
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ASP.NET 

Separate Form, Function, 
and Style 

Build dynamic and flexible Web apps 
using Visual Studio .NET's built-in 
suppott fot creating and modifying 
content with XML technologies, 
by Don Kiely 
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Database Design 

Boost Performance With a 
DataRelation 

The DataRelation class in ADO.NET 
offers client-side data-integrity 
validations that make your apps perform 
better, and navigation functionality that 
reduces development time, 
by Paul Delcogliano 
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Visit Visual Studio Magazine online to read these exclusive articles and more: 

Create Web Service 
Storefronts 

Locator* code: VSEP021 11 1ANT 

Keep your business logic centralized by 
implementing multiple Web service 
interfaces that act as gateways into it. 
Download a complete sample app that 
demonstrates these "storefronts." 
by Jonathan Goodyear 
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Rotate Text Easily With GDI+ 

Locator* code: VSEP021031CS .T 

Rotating text and graphics was 
cumbersome with the old Windows 
Graphics Device Interface. You'll be 
happy to learn how simple it is in .NET 
using the new GDI+. 
by Bill Wagner 

Automate Stored Procedure 
Parameters 

Locator* code: XMEP021 1 0SXM T 

Dealing with parameters in stored 
procedures can be laborious and time- 
intensive. Simplify the process with 
XML — download a sample app to show 
you how. 

by Dan Wahlin 



Tips for Cloning ASP.NET 
Web Forms 

Locator* code: VSEP021 1 13AN.T 

Save development time by reusing 
existing Web forms and importing 
Windows form code to ASP.NET 
projects. Also, learn what pitfalls to 
avoid in the cloning process, 
by Roger Jennings 




More Than 400 .NET Books 

FTPOnline presents every .NET book we 
could find — more than 400 books from 
almost two dozen publishers, about 
everything from ADO. NET to C#to XML. 

Browse or search the list at 
www.fawcette.com/books/ 



SIGN 
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Every week, the .NET Insight e-mail newsletter brings you up-to-date news, technical 
information, opinions, interviews, and analysis on topics and technologies such as Ex- 
change, Visual Basic .NET, C#, SQL Server and data access, ASP.NET, .NET Servers, 
wireless, Web services, and XML. Sign up for free at www.visualstudiomagazine.com. 



Locator* Defined 



Go Online! 



Type in this Locator* code to download the 
code for this particular article. You can 
also get the code for this article by pulling 
up the article itself, then clicking on the 
link to the accompanying code. — 

Type in this Locator* code to discuss this 
article with the author and other readers in 
VSM's online discussion forums. 

This Locator* code brings up the article 
itself, along with any code listings, 
sidebars, and other extra content that 
wouldn't fit in the printed edition of the 
magazine. 

This Locators code brings up a past article . 

on a related topic. 



Use these Locator* codes at 
www.visuatstudiomagazine.com 

to go directly to these related resources. 

Download 

■ VS0302FB Download the code for this 
article, which includes a VB.NET project 
whose classes show several features of 
inheritance and other aspects of OOP. 

Discuss 

VS0302FB_D Discuss this article in the 
VB.NET forum. 

Read More 

• VS0302FB_T Read this article online. It 
includes Listing 1 and a sidebar containing a 
glossary of object-oriented terms. 

VS0110BP_T Best Practices, "Don't Overuse 
Inheritance," by Bill Wagner 
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Compuware can help. DevPartner™ Studio tracks underlying 
events and transactions running across multiple tiers and 
environments, for both native Microsoft languages and .NET. 
Working from inside the Visual Studio .NET IDE, DevPartner Studio 
gives you runtime data, down to the spot where the jam occurs. 
You pin down bottlenecks in no time, right at the source. Now 
how's that for taking charge? 

Compuware, a premier Microsoft independent software vendor 
for performance profiling, is offering a free download of 
DevPartner Profiler Community Edition. For information, visit 
offers.compuware.com and enter 3019X20 or call 
1-800-686-6342. 
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COMPUWARE 



Integrating 
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Researching a Path 
to Fewer Bugs 



The process of writing computer software and applications 
tends to range from highly complex to exponentially more 
complex. One obvious consequence of this complexity: 
bugs. They plague developers at all levels of the development 
spectrum, whether you create database front ends, build back- 
end commerce sites, or write device drivers. 

Bugs have been a particular source of concern for Microsoft 
itself, which has been chastised frequently for lax security and a 
seemingly unending stream of bug fixes and service packs. In the 
past year, Microsoft has emphasized its commitment to creating 
both more secure and more reliable applications. A white paper 
on its site details Microsoft's Trustworthy Computing initiative: 
"If computing is to become truly ubiquitous — and fulfill the im- 
mense promise of technology — we will have to make the com- 
puting ecosystem sufficiently trustworthy that people don't worry 
about its fallibility or unreliability the way they do today." 

With this in mind, I sat down recently with Jim Larus, a se- 
nior researcher at Microsoft Research who leads the Software 
Productivity Tools research group (http://research. microsoft, 
com/spt/). We spoke about the tools Microsoft Research is 
working on that will help the company to reduce bugs in its 
products. 

One of the primary goals of Larus' group is to develop tools 
that analyze projects to locate bugs as an application is com- 
piled. Microsoft has been researching a model checking ap- 
proach that it adapted from the hardware world that verifies 
state machines for software. The Software, Languages, Analysis, 
and Model checking project (SLAM) analyzes software as a 
complicated state machine, ensuring that a particular rule is fol- 
lowed, no matter what path a user might navigate in an appli- 
cation. For example, assume you want to make sure that a cer- 
tain event never takes place before another event. This ap- 
proach can take exponentially large state machines and check 
them for particular rules completely. 

You can exploit this tool by creating a set of rules that gov- 
ern a given application. Programs can travel many paths, and 
it's hard to check them all, especially in little used paths, which 
tend to be the source of many difficult-to-trace bugs. This ap- 
proach lets you test a particular condition for any possible state. 
It can tell you when and where a rule is violated; sometimes, of 
course, the violation doesn't indicate a bug, but rather that the 
rule itself is flawed. 



Larus noted that Microsoft 
has adapted this SLAM project 
to create the Static Driver Veri- 
fier (SDV). His team worked 
with the group in Microsoft re- 
sponsible for creating device 
drivers to come up with a large 
list of rules. Device drivers are 
extremely complicated and the 
source of many crashes that end 
users experience. SDV enables 
you to write a single set of rules 
you can apply to the literally 
thousands of drivers that exist 
for various flavors of Windows. 
Larus indicated that Microsoft 
tests third-party device drivers 
with this tool as well. This is im- 
portant because when a third- 
party device driver fails, it looks 
like it's the OS that has 
bombed. In a sense, it has, but 




Patrick Meader 

Editor in Chief 

■BBSS®;' 

Would you like to see 
tools such as SLAM and 
SDV make their way into 
Visual Studio? Discuss 
this in the Talk to the Edi- 
tors of Visual Studio 
Magazine forum on our 
Web site. Use this Loca- 
tor code:VS0302EIM_D 



the code that brought it crashing 
down isn't code that Microsoft created. Running SDV on 
third-parry device drivers should have a significant practical ef- 
fect for all those who use Microsoft toolsets. 

It's all well and good that Microsoft has such tools at its dis- 
posal internally — no one is going to complain about more reli- 
able development tools, servers, and operating systems. But one 
can't help but wonder when, if ever, rank-and-file developers 
might be able to get their hands on these kinds of tools in their 
own work. Larus indicated that there's no timeframe for deliv- 
ering such tools to Visual Studio users — the tools in their 
present state are useful, but also rough around the edges and re- 
quire a lot of handholding. That said, he noted: "Obviously, as 
a researcher, I'd love rank-and-file programmers to be able to 
take our tools and be able to use them in their everyday jobs. 
It's gratifying to think that the work you do as a researcher can 
make people's lives easier." 

Here's to hoping such tools make the transition to consumer 
products or are eventually included as part of Visual Studio 
.NET. 
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Old Technology 
Wrapped and Bundled 

Free* 



* Call for actual pricing, licensing restrictions and possible side effects. 




New Technology 
Fully Integrated Managed Code 

Priceless* 




Active eports™for .NET 



t Easy to Learn, Easy to Use, Easy to Deploy, Easy to License 

DATA 

www.datadynamics.com • 61 4.895.3 1 42 



DYNAMICS 



Letters to Visual Studio Magazine are 
welcome. Letters must include your 
name, address, and daytime phone num- 
ber to be considered for publication. Let- 
ters might be edited for form, fit, and 
style. Please send them to Letters to the 
Editor, c/o Visual Studio Magazine, 913 
Emerson St., Palo Alto, CA 94301; fax 
them to 650-853-0230; or e-mail them to 
vsmedit@fawcette.com. 

More Controls Coverage 

I just finished reading the article, "Boost 
Web Performance With Multithreading," 
by Timothy M. Chester [VSM November 
2002], and would like to compliment him 
on his multithreading example and clear 
writing skills. The code illustrates not only 
multithreading, but also some pretty neat 
XML and XSL techniques (such as the XML 
control) for GUI output with a minimum of 
code. Thanks, Tim, for the great article and 
example. 

Which brings me to another point: Un- 
less you have all day to explore all the controls 
and components built into VS.NET, you 
probably wouldn't have any idea of the exist- 
ence of the XML control or how to use it. 
Maybe VSM could start a column that exam- 
ines and shows how to use the built-in 
VS.NET controls and components thataren't 
covered copiously elsewhere else (such as 



DataSet and DataReader, which are covered 
a lot everywhere). As a developer with limited 
time resources, this would be a great resource 
to access. 

Dennis Adams, Grand Rapids, Mich. 

Go Online! 

Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these related resources. 

Download 

VS0302: All the listings and code files for the 
February 2003 issue of VSM'm one ZIP file 

VS0302FB: "Leverage VB.NET's Object- 
Oriented Features": a VB.NET project whose 
classes show several features of inherit- 
ance and other aspects of OOP 

VS0302DT: Desktop Developer: the 
CollapsingControls project and a test 
application that includes a project reference 
to CollapsingControls 

VS0302QA: Q&A: the Synchronizer project, 
which contains a WinForms client that uses 
a Calculator class employing a generic 
implementation of ISynchronizelnvoke; and 
the HtmlClip project, which contains 
routines for sending HTMLto the clipboard 

VS0302AN: ASP.NET: an ASP.NET 
application that demonstrates how to 
combine XML, XSLT, and CSS to make 
flexible and responsive Web applications 

VS0302DD: Database Design: code that 
creates a DataRelation on columns in the 
Northwind sample SQL Server database's 




Celebrate the 
Power of 10! 

VSLivel's 10th Anniversary and Contest 

For more than a decade, VSLive! conferences have been bringing you real-world, 
pragmatic tips and techniques for developing better and faster with Microsoft technolo- 
gies. Join the editors of Visual Studio Magazine and the VSLive! team in a celebration 
of 10 years of success with a fun, interactive contest — you could be eligible to win an 
assortment of prizes with an overall value of $25,000! 

• 1 weeks of quizzes and challenges posted online throughout the www.vslive.com 
and www.visualstudiomagazine.com Web sites 

• A winner a week— unlimited books, software, and other prizes can be yours just 
for knowing your stuff! 

• All correct entries generate points that count towards a grand prize. The grand- 
prize winner will be announced at VSLive! San Francisco. 

For complete details on the prizes and contest rules, 
go to www.vslive.com today! 
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First Looks 



Troubleshoot PL/SQL 



The DevPartnerDB Debugger for Oracle Visual Studio Edition 
simplifies debugging Oracle stored procedures from within 
.NET. It integrates fully into VS.NET and — once you do a little 
setup — operates identically to the VS.NET debugger. 

You gain access to the PL/SQL Debugger project once you 
install DevPartnerDB. You use this new project type to add Oracle 
stored-procedure debugging to your applications. When you acti- 
vate the PL/SQL Debugger project, you're dropped into Dev- 
PartnerDB whenever your code uses an Oracle function or proce- 
dure. DevPartnerDB allows you to set breakpoints, examine and 
modify PL/SQL variables, set watches, and view the call stack. It 
performs all the functions the VS.NET debugger supports, includ- 
ing menu functions and special keys. DevPartnerDB also color 

DevPartnerDB Debugger for Oracle Visual Studio Edition 
Compuware 

Web: www.compuware.com 
Phone: 800-521-9353 
Price: $1,800 

Quick Facts: Supports watches, breakpoints, and all other common debug- 
ging activities for Oracle PL/SQL functions. 

Pros: True debugging of Oracle functions and procedures; fully integrated into 
VS.NET. 

Expensive and would benefit from stronger documentation. 
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Tame PL/SQL. DevPartnerDB brings full-featured Oracle stored- 
procedure debugging to VS.NET. It allows breakpoints, watches, 
single stepping, and all the other debugging features you've come to 
expect. It's ideal if you call Oracle functions and procedures frequently 
from .NET. 

codes SQL keywords and letters and displays a variable's value when 
you hover over it with the cursor. 

You can step through your PL/SQL to examine both flow of 
execution and variable values until you find all problems — a big 
improvement over running the function and examining its results 
until the problem becomes apparent. DevPartnerDB even steps 
into nested procedures, including Oracle built-in functions such as 
NVL. These capabilities should be everything you need to trouble- 
shootyour PL/SQL. Compuware has also assured me DevPartnerDB 
works with the new Oracle provider objects, though I did all my 
testing with the standard OleDb objects. 

I was disappointed by a few aspects. The documentation could be 
improved; I'd like to see Compuware include a beginner's tutorial 




Build Web Portals 

Passage Portal 2.0 from Cubic Compass facilitates creating both 
Internet and intranet portals. It uses stylesheets to drive your 
portal's overall appearance, making visual changes relatively pain- 
less. Passage Portal also supports multiple portals off the same server, 
and srylesheers help you brand each portal distinctively. The prod- 
uct also provides out-of-the-box access to significant content. 

Passage Portal defines high-level sections by default, including 
My Pages, Home, Products, Contact Us, Services, Partners, Em- 
ployees, Admin, and Tools. You can create additional sections, 
subsections, and content. The default content categories are Gen- 
eral, Administration, News, Reference, Content Management, 
Community, Accessories, Office, and Reports. 

Passage Portal lets you incorporate several plug-in components 
for each category into your pages. The Administration section's 
components configure themes, content, users, and roles. This sec- 

. "■■'I* il'llilllll » 

Passage Portal 2.0 

Cubic Compass 

Web: www.cubiccompass.com 

Phone: 503-520-0845 

Price: Starts at $4,995 

Quick Facts: Portal-creation software. 

Pros: Significant content and components available. 

Cons: Documentation, Ul. 




Add Portal Components. Passage Portal provides a virtual cornucopia 
of components you can place on your portal pages. This page lets the 
user make a color selection, which fires off an event that changes a 
consumer component's background color. This page also includes a 
community calendar component. 

tion provides MSN news products such as MSNBC Business News 
and Stock Ticker, and multiple categories of content from Moreover. 
You can add Google search and dictionary/ thesaurus content through 
the Reference section. The Community section's features include 
Web surveys, event calendars, user feedback, and even access to 
traffic cameras in some cities. 

The Accessories section's components provide simple calendar- 
ing, contact information updates, a notepad, and My Favorite 
Links. The Office section provides links to Outlook Calendar, 
Inbox, or a combination of the two. Two built-in reports are 
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Troubleshoot PL/SQL 

showing how to set up both the .NET code 
and the PL/SQL. You must compile your 
stored procedures for debugging before they'll 
work. You also have to activate stored proce- 
dures with OleDbCommand objects using 
the adCmdStoredProc command type. The 
code window allows you to edit your PL/ 
SQL, but there's no mechanism for saving 
your edits back to the database, so the code 
window should probably be read-only. Fi- 
nally, I wasn't able to get the debugger to 
activate for a function I used in a Select 
statement. Compuware support was helpful 
getting me through all these limitations, but 
the company needs to address them within 
the product's documentation. However, none 
of them is a serious issue. They're typical of 
problems in early debugger releases, and you 
can work around them easily. 

DevPartnerDB is a strong tool for inte- 
grating PL/SQL and VS. NET development. 
It's a full-featured debugger with a few limi- 
tations, strong support, and documentation 



that needs work. At $ 1 ,800, it's an expensive 
development tool, but a good debugger can 
save you many hours of frustration. If you 
use PL/SQL and VS.NET extensively, Dev- 
PartnerDB merits your serious consider- 
ation. 



Andy Clark is a consultant in the Richmond, 
Va., area. He's an MCSD and JCP with exten- 
sive Oracle and SQL Server experience. Reach 
him at theandyclark@hotmail.com. 

Build Web Portals 

available; one produces a list of portal users 
and their statistics, and the other generates a 
user e-mail list. 

A component can trigger an event that 
affects another component's appearance or 
functionality. You can also plug in your own 
custom ASP.NET components. 

The Web-based configuration of the 
portal could stand some improvement. The 
method for adding pages can be time- 
consuming when you build a larger site. 



The documentation also needs enhancing. 
An administrator's guide is on the install 
CD, but it's not part of the installation, 
and it doesn't go into depth about the 
controls or the content that MSN and 
Moreover provide. You discover the avail- 
able newsfeeds and content only by explor- 
ing the configuration screens. Online help 
is unavailable within the portal. And it's 
imperative for a product this flexible to 
provide a tutorial that steps users through 
creating a sample site. Passage Portal is 
powerful and versatile, but the documenta- 
tion and configuration issues make it diffi- 
cult to exploit its power and versatility that 
real-world circumstances demand, wsm 



Marc Mercuri is the vice president of applica- 
tions development for Gazelle Systems and a 
Microsoft Certified Solutions Developer. He 
has architected, managed, and developed 
projects for the CRM, financial, educational, 
hospitality, entertainment, medical, POS, and 
publishing industries. Reach him by e-mail at 
mmercuri@delivereddigital.com. 



Product Listings 



Editor's Note: Please send product informa- 
tion to Hew Products Editor, c/oVisual Studio 
Magazine, 913Emerson Street, Palo Alto, CA 
94301; fax 650-853-0230; e-mail vsmedit® 
fawcette.com. 

IP*Works! for the Microsoft .NET 
Compact Framework 

IP*Works! for the Microsoft .NET Compact 
Framework provides dozens of royalty-free 
components for implementing Internet com- 
munication, security, and compression within 
the .NET Compact Framework, including fully 
managed components for Internet develop- 
ment implementing Internet protocols such 
as HTTP, FTP, SOAP, SMTP, POP, IMAP, 
SNMP, NNTP, XML, MIME, and Telnet. Con- 
tact vendor for pricing. 
In software 

Phone: 800-225-4190; 919-402-0590 
Web: www.nsoftware.com 

mciMenu 

mc.Menu provides XML-configurable dy- 
namic menu componentsforASP.NET appli- 
cations targeting Microsoft Internet Explorer 
5.0 and above. The product consists of fully 
managed .NET components written in C#. 
Features include XML configuration files for 
customizable attributes; vertical main menu 
items with one-level-deep popup submenu 
items; a submenu indicator; clickable and 
informational menu items; and menu item 
groupings, dividers, and tooltips. $99. 



Mimsware 

Phone: 770-516-2142 

Web: www.mimsware.com 

QuickCode .NET 

QuickCode .NET is a Visual Studio .NET add- 
in that lets you design and use QuickCodes — 
code fragments you can insert into the Visual 
Studio .NET text editor when the current line 
matches a specific pattern. QuickCode .NET 
currentlysupports C#, VB.IMET, and ASP.NET. 
You can design and test each code fragment 
from within the VS.NET IDE, using a color 
syntax highlighting text editor. Free. 
Development Expertise 
Phone:+31-0-20-620-56-97 
http://quickcode.dvxp.com 



DBWatch 2.01 

DBWatch is a Windows-based debug utility 
for programsthat modify the data tables of an 
Access or SQL Server database. DBWatch 
provides a difference report between any 
two points in time on the data tables in the 
target database. The display resembles that 
of a file-compare utility such as Microsoft 
WinDiff. You can display the data tables us- 
ing any index defined in the database. You 
can write the difference report to an ASCII 
file, allowing you to study it later or e-mail itto 
another site. DBWatch can execute a differ- 



ence report on 20,000 records in about two 

seconds. $25. 

SRF Engineering 

Phone:949-551-2699 

Web: www.inventionsbysrfeng.com 

DevPartnerDB 4.1 for Microsoft 
SQL Server 

DevPartnerDB 4.1 for Microsoft SQL Server is 
a comprehensive application development 
tool for building, debugging, and monitoring 
Transact SQL-based stored procedures in 
SQL Server 7.0 and SQL Server 2000 data- 
bases. You can observe the execution of all 
SQL statements in context, including ones 
executed automatically by the database. 
DevPartner DB 4.1's new features include 
stored procedure performance profiling, 
which lets you pinpoint performance bottle- 
necks by tracking and evaluating the effi- 
ciency of a database's queries and stored 
procedures. Other new features include en- 
hanced XML support and implementation. 
Contact vendor for pricing. 
Compuware 
Phone: 800-468-6342 
Web: www.compuware.com 

RoboHelp X3 

RoboHelp X3 lets you create multiple help 
systems and print-quality documentation in 
various online formats for Windows and 
Web-based apps, including .NET. Features 
include conditional text with preview mode. 



airplane (that is, offline-accessible) help, 
single-sourcing, customizable skins, help 
system merging, batch processing, context- 
sensitive help, and new usability features. 
RoboHelp X3 links to any C, C++, VB, Java, 
Delphi, or Web-based app. Automated wiz- 
ards create help-specific features such as a 
table of contents, index, and glossary. The 
Enterprise version supports server-based 
help. Starts at $899. 
eHelp 

Phone: 800-358-9370 
Web: www.ehelp.com 

Visual Case 2.2 

Visual Case 2.2 is a design tool for software 
development, database design, and business 
analysis. It supports SQL Server, Access, 
Oracle, Sybase, and MySQL, and it reverse- 
engineers most ODBC data sources. Visual 
Case 2.2 integrates the UML modeling lan- 
guage, legacy diagrams, and database de- 
sign tools with round-trip database engineer- 
ing and a SQL Editor. Diagram types include 
UML, entity relationstiip, flowcharts, and data 
flow. The Ul provides autolinking, alignment, 
and spacing tools. Version 2.2 adds quick 
links from the selected object to other ob- 
jects, autodraw link options, and Access XP 
support. §449. 
Artiso 

Phone:416-231-6911 

Web: www.visualcase.com 
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CASE STUDY 



.NET Automates 
Currency Purchasing 

An ideal IT project provides a solution that saves 
money and time, while providing better customer 
service and satisfaction. Volunteer Corporate 
Credit Union (VolCorp) of Nashville, Tenn., has 
achieved that goal with its latest undertaking. VolCorp uses 
Visual Studio .NET to reduce mounds of paper and massive 
man-hours in manually processing that paper. VolCorp created 
this project to improve customer service in handling currency 
purchases for its 235 member credit unions, part of a suite of 
financial services it provides. 

The benefits? Measurable and tangible: 

• 90% of customers use the Web-based currency trading solu- 
tion instead of calling in 



• Customers can place orders 24/7, not only on designated 
trading days 

• 80% reduction in incoming currency trading phone calls 

• 15% overall reduction in incoming customer calls 

• Customer transaction time now one to three minutes on Web 
instead of five to eight minutes on phone 

• Two weeks total development time using Visual Studio .NET 
and Infragistics NetAdvantage Suite 2.0 

The Challenge 

In the previous system, Member Services Representatives 
(MSRs) took currency purchasing orders at the call center, 
wrote them down on paper, and then placed the orders at the 
end of the day. This manual system brought the danger of 



Solution Overview 



Company 

Volunteer Corporate Credit Union (www.volcorp.org) 

Customer Profile 

Volunteer Corporate Credit Union (VolCorp) is a not- 
for-profit financial cooperative that serves member credit 
unions nationally. 

Business Situation 

Need to improve customer service and reduce costs by 
automating real-time currency purchasing for member 
corporations of the credit union. Previously done over 
the phone with VolCorp Member Service Rep. 

Solution Description 

Deployed and implemented an ASP.NET based solution 
using Microsoft® Visual Studio® .NET and Infragistics' 
NetAdvantage Suite 2.0. 




Industries 

Services 



Benefits 

• Ease of use 

• Fast time-to-market 

• Reduced costs 

• Reduced manpower 

• Increased customer service and satisfaction 

• Web-based security based on user credentials 

• Compliance with Federal Reserve guidelines 

Software and Services 

Microsoft ASP.NET 

Microsoft .NET Framework 1.0 

Microsoft SQL Server 2000 

Microsoft Visual Studio .NET 

Microsoft Windows 2000 Enterprise Server 

Microsoft Windows XP Professional 

XML Web Services 

Country/Region 

United States 
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www.volcorp.org 



Servers 




incorrect or misplaced orders, causing unnecessary delays and 
customer frustration. 

Currency trading calls took a lengthy five to eight min- 
utes — time not spent on other calls, and time that could be 
better spent on other tasks. VolCorp realized it could save 
both phone and paper handling time ^^^^^^^^ 
by addressing the problem with new 
.NET technology. 

VolCorp analyzed its processes and 
uncovered the need to automate its 
manual, paper-based system to record 
and place orders. When routing busi- 
ness through a call center, two factors 
were system bottlenecks: the number 
of employee hours available and the 
length of the calls that those employ- 
ees handled. Only a certain number 

of calls can be handled in an hour with 

a fixed number of employees. The MSRs also have other duties 
they need ro attend to in addition to raking calls for currency 
and coin purchases. 

Besides business process benefits, automation promised in- 



"Thanks to the Infragistics 
ASP.NET Grid's drag and drop 
functionality I was able to create 
complex hierarchical grids in a 
short amount of time without 
writing a line of code. " 

- Sean Wilkins, Developer & Analyst, 
Volunteer Corporate Credit Union 



creased customer service. VolCorp wanted to keep a real-time 
connection with its customers, while reducing the on-phone 
time for its MSRs. This, in turn, would reduce the costs for 
processing currency coin purchases, purchasing requests, as well 
as decrease the overall support costs. 

^^^^^^^^ Because its customers had 

Internet access, VolCorp investigated 
opening up order processing through 
a secure application hosted on the 
Internet. Implementation had to be 
simple and the resulring system had 
to be easy to support with the exist- 
ing IS team. Above all, the new sys- 
tem had to work for the end users. 

VolCorp currently has an exten- 
sive Web site written in standard ASP 
using VB Script and JavaScript. They 
also have a Web site design consult- 
ing services group that has created, and still maintains, over 30 
ASP Web sites for other credit unions. So ir made sense to use 
that expertise and build an ASP-based application to handle the 
currency transactions. 




III I Advertising Section 



The .NET Solution 

The solution turned out to be an ASP.NET Web Application 
written with Visual Basic .NET. The VolCorp team had expe- 
rience with .NET through the beta program, and were in the 
process of writing two non-Web applications in .NET using 
Visual Basic .NET VolCorp chose ASP.NET over classic ASP 
because they liked the ease of development with Visual Studio 
.NET and the ability to separate the presentation layer from 
code. They also needed to use existing in-house code to support 
the business rules, and they wanted a quick "time to market" 
with the new application. 

VolCorp chose to use Visual Basic NET because of famil- 
iarity. Nothing, VolCorp developers felt, compelled the team 
to move from Visual Basic when moving to .NET. VolCorp 
developers wanted to stay with the language that they already 
knew rather than switch to another language. 



Rapid Development 

With a familiar language, and a new 
programming model in ASP.NET, 
VolCorp was able to move the project 
from start of design, through develop- 
ment and debugging, and to comple- 
tion in two weeks. VolCorp has a de- 
velopment staff of four developers, one 
of whom worked on this project. How 
was VolCorp able to develop an appli- 
cation so quickly? 

VolCorp had legacy COM compo- 
nents that it wanted to expose to the ASPNET application. Expos- 
ing these components as Web service methods saved hours of time 
versus re-writing them in .NET code. The developers were able to 
quickly expose current business rules to the under-construction 
ASP.NET Web solution. 

With the business layer solution defined, it was time to look 
at the presentation layer. Even though Visual Studio .NET has a 
wide array of standard controls, VolCorp wanted to take advan- 
tage of an existing relationship with Infragistics Inc. VolCorp uses 
several of Infragistics' products in its current COM-based appli- 
cations. What attracted VolCorp to the Infragistics NetAdvantage 
Suite was the ability to customize the Infragistics controls. 

The Infragistics controls are easily extendable because the 
Visual Studio .NET IDE opens up more functionality to third- 
party vendors. This is one of the major things that allowed the 
project to move along so quickly — both the rich client-side and 
server-side functionality provided by the NetAdvantage Suite. 

Solution Architecture 

The basic system architecture uses a Web browser talking to an 
ASPNET application written in Visual Basic .NET, on a Win- 
dows 2000 Server. The Web Forms of the ASP.NET solution 



talk to both .NET classes and various objects through Web ser- 
vices. SQL Server 2000 is used as the backend data store and is 
accessed via ADO.NET. 

As you might expect, this site is protected by Internet Infor- 
mation Services (IIS) and ASP.NET. The credentials are checked 
at login through Windows Authentication. Using almost any of 
the authentication methods in ASP.NET, by default, the login 
credentials are passed from the Web browser to the IIS/ASP.NET 
server in plain text. To address this problem, VolCorp uses an 
HTTPS connection to secure this and other private "conversa- 
tions" that occur in a transaction. 

The application also contains a roles-based hierarchy that 
allows different functionality for various users. The Infragistics 
menus on the site are populated based on the unique permis- 
sions of the logged-in user. Once authenticated, the user is routed 
to the order page that collects data for the order. In addition to 
, 7 ,.. 5a placing orders, the site also allows us- 

ers to review their purchase histories 
and the status of any pending orders. 

The ASP.NET pages used for the 
presentation layer make calls into 
Web services in addition to in-pro- 
cess .NET classes. The Web service 
methods, in many cases, are wrappers 
around existing COM objects that 
were already in service in other appli- 
cations at work in the company. The 
COM objects contain much of the 
complex business rules that determine 
the purchasing process. The middle tier of the system accesses 
the data on SQL Server 2000, which is running on the data tier. 

Page output is based on data pulled from the backend data- 
base, which is bound to the Infragistics controls and pushed 
down to the client as standard HTML. 

The Results - Surpassed Expectations 

VolCorp started the project with three objectives: rapid de- 
ployment, the elimination of paper processing (and, thus, a 
reduction in MSR time on purchase calls), and finally ease of 
use for the users. Volcorp met all three of their objectives with 
the ASP.NET solution. The application was completed in about 
two weeks of development time. When the system goes live 
this quarter, it will eliminate paper processing which will re- 
duce the total call volume by 15%, and greatly enhance Web 
support for their customers. After only one month of avail- 
ability, VolCorp forecasts that over 90% of their currency pur- 
chasing customers will use the automated Web site to pur- 
chase currency. Currency-purchasing-related phone calls will 
decrease by 80%. 

Although it was not in the original plan, the project held an 
additional benefit. While the US Federal Reserve allows orders 



"Thanks to the robustness of the 
. NET Framework, Infragistics ' 
ASP.NET components allow devel- 
opers to create the rich look and 
feel and interaction their users are 
accustomed to in a thin-client 
environment. " 
- Dean Guida, Infragistics CEO 
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to be made only on certain days, the past system meant orders 
had to be placed on those days. Now orders will be automati- 
cally queued for their day to order. Plus members now have 
access to the application anytime, any day. 

Finally, the implementation of this ASP.NET application has 
additional projected benefits for VoiCorp: 

• 25% overall reduction of time spent on phone with 
customers for MSRs 

• Reduction in paper 

• Instantaneous answers for members; using online 
solution members can see details of their purchase 24/7 

• Reduced time on purchasing calls 

When presented with a choice between phone calls or an 
online solution, customers prefer the flexibility of online trans- 
actions. And when an IS department can build an online solu- 
tion quickly using Microsoft Visual Studio .NET and Infragistics 
ASP.NET, it makes the choice simple. As Ben Williams, VP 
of IS at VoiCorp, puts it, "The combination of Infragistics' 



NetAdvantage Suite and Microsoft's ASP.NET provided rich 
client functionality with the cost advantages of thin client de- 
livery." Functionality, together with a quick turn around and 
increased customer satisfaction, equals a winning combination. 

For more information, visit www.microsoft.com/vstudio and 
www.infragistics.com. ■ 

Microsoft 

Microsoft, Visual Studio, Visual Basic, BizTalk, SourceSafe, Visual C#, 
and Windows are either registered trademarks or trademarks of Microsoft 
Corporation in the United States and/or other countries. The names of 
actual companies and products mentioned herein may be the trade- 
marks of rheir respective owners. 
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VB.NET's Object- 
Oriented Features 

Write elegant and easily maintainable code by taking advantage of 
inheritance and other object-oriented capabilities. 
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□ SQL Server 2000 

□ ASP.NET 
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Go Online! 



by Francesco Balena 

One of the most compelling reasons for switching from VB6 to 
VB.NET is VB.NET's full support for object-oriented program- 
ming (OOP). However, you need to do more than learn some new 
keywords to take advantage of this capability. The many options you now 
have can be puzzling. I'll show how you can use object-oriented features 
in your applications. I won't explain every new feature in depth (a task this 
entire magazine couldn't accommodate), and I'll provide code examples 



Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these resources. 

Download 

VS0302FB Download the code for 
this article, which includes a 
VB.NET project whose classes 
show several features of inherit- 
ance and other aspects of OOP. 

Discuss 
VS0302FB_D Discuss this article in 
the VB.NET forum. 

Read More 

VS0302FBJT Read this article 
online. It includes Listing 1 and a 
sidebar containing a glossary of 
object-oriented terms. 

VS0110BP_T Best Practices, "C 
Overuse Inheritance," by Bill 
Wagner 

VS0111BPJT Best Practices, 
"Create Maintainable Classes 
David J. Roberts 




that contain remarks in lieu of executable code 
to draw your attention to general concepts 
(download the examples from the VSM Web 
site; see the Go Online box for details). You 
might be unfamiliar with some wotds I use, so 
I've provided a glossary of the most common 
OOP terms (download the sidebar, "An Object- 
Oriented Glossary"). 

The first new object-oriented language fea- 
ture you're likely to use extensively in your apps 
is method overloading. VB.NET lets you define 
more than one method or property with a given 
name, provided the versions differ in their argu- 
ment signatures; that is, the number or type of 
their arguments must be different. For example, 
a class can define a Getltem method that takes 
either a numeric index or the string key you 
associate with the element to be returned: 

Function Getltemt By Val index As 

Integer) As Object 

' return an element by its index 
End Property 

Function GetltenH ByVal key As String) _ 
As Object 



' return an element by its key 
End Property 

The compiler generates the call to the correct 
version by looking at the argument's type: 



res = obj . Getltemt 1 ) 
res = obj . Getl tem( " Joe" ) 



numeric key 
string key 



Method overriding is especially useful when you 
have a highly generic method that can take any 
data type — for example, a Log method that 
appends the argument's value to a text file. You 
might be tempted to define a single version that 
takes an Object argument, because you want to 
pass any type of data to this method: 

Sub LogtByVal value As Object) 
' TW i s a TextWriter object 
tw.WriteC'LOG:" & val ue.ToStri ng( ) ) 

End Sub 

However, you force a hidden boxing operation if 
you pass a value type argument — a number, a 
date/time, a Boolean, or a structure — to an Ob- 
ject argument. The .NET runtime must wrap an 
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object around the value — an operation that allocates memory from 
the managed heap and wastes precious CPU cycles. 

A better approach is to define an overloaded version of the same 
method for each data type you want to support. If you don't want 
to write code for every possible argument type, you can implement 
one version that takes a Long argument (which can handle Boolean, 
Short, Integer, and Long values), another version that takes a 
Double argument (which can also handle Single values), and two 
more overloaded versions that take a DateTime value and a Decimal 
argument. These four versions can deal with the most common 
value types, leaving the task of handling reference types (such as 
strings) or more specific objects (such as Person) to the overloaded 
version that takes an Object argument. Passing a string or a specific 
object to the version that takes an Object argument involves no 
CPU overhead because it doesn't force a boxing operation. 

Constructors Provide Robust Classes 

When creating a class library, you should always prefer multiple 
overloaded methods to a single method that takes optional argu- 
ments, because some other .NET languages (most notably C#) 
don't recognize optional arguments. Remember that two over- 
loaded methods can't differ in only their return value or the ByVal/ 
ByRef keyword you use in front of each argument. (The ByVal/ 
ByRef keyword limitation applies to VB.NET and some other 
.NET languages; C# allows you to define two methods that differ 
only in the ref or out keywords.) 

The next object-oriented feature you should explore is construc- 
tors. A VB.NET constructor is a procedure named Sub New, which 
is invoked when a client creates an instance of the class. If your code 
doesn't contain an explicit constructor, the VB.NET compiler 
automatically adds a default constructor — a constructor that takes no 
arguments. You can't instantiate the class without an explicit or an 
implicit constructor. VB.NET also lets you define a constructor 
with arguments, so you can force clients to initialize the fields 
necessary to create the object in a valid state: 

' a read-only field can be set only 
' from inside a constructor procedure 
Public Readonly Filename As String 
Sub NewtByVal filename As String) 
1 ensure filename isn't null 
If filename Is Nothing OrElse 
Filename. Length = Then 

Throw New ArgumentExcepti on ( " I nval i d file name") 

End If 

' assign to the read-only field 
Me . Fi 1 eName = f i 1 ename 
End Sub 

Multiple constructors with arguments often have code in com- 
mon — for example, the code that validates one or more arguments. 
In this case, you can simplify your class' structure by having one 
constructor call another constructor: 

Public Readonly Overwrite As Boolean 
Sub NewtByVal filename As String. _ 

ByVal overwrite As Boolean) 

' a call to another constructor MUST 



' be the first executable statement 
Me . Newtf i 1 ename ) 
' assign remaining fields 
Me. Overwrite = overwrite 
End Sub 

An interesting problem arises when you need both the default 
constructor and one or more constructors with arguments. In this 
case, you must declare an empty Sub New procedure explicitly, 
because the compiler doesn't create one for you automatically: 

Sub New( ) 

' no need to add code here 
End Sub 

The constructor's scope has serious implications on the class's 
behavior. A Friend constructor in a Public class makes the class 
creatable only from inside the same assembly, so it corresponds 
broadly to the PublicNotCreatable setting you can use for VB6 
classes. A private constructor makes the class not creatable at all, 
which makes sense if the class is merely a container for shared 
methods. (System. Console and System. Environment are examples 
of these classes.) More precisely, a piece of code can instantiate a class 
with a private constructor only if that code resides inside the class 
itself or inside a nested class, because a nested type can access private 
members of the type that encloses it. A simpler way to create a 
VB.NET class that contains only a shared member is to define a 
Module block. Module blocks are regular, noncreatable classes 
whose members are implicitly static. Notice that the .NET runtime 
is oblivious to modules (and C# developers don't have them): 
VB.NET supports modules only to ease the migration of VB6 code, 
and the compiler converts all members inside a Module block into 
static members transparently. 

Pay Attention to Field Initializers 

The previous description might seem to imply that private construc- 
tors are useful only rarely, but this isn't true. For example, it might 
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v ; v|[Ej Class Customer 

Inherits Person 

Public Title As String 



Overrides Function CompleteName ( ) As String 

Return Title £ " " £ MyBase . CompleteName ( ) 

End Function ' 



Figure 1 Let Visual Studio .NET Create Overridden Methods. If 

your class derives from a class other than System. Object, you can 
create the template for an overridden property or method by select- 
ing the (Overrides) element under the class's name in the left-most 
combo box at the top of the code editor window, then selecting the 
member to be overridden in the list that appears in the right-most 
combo box. 
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be convenient to define a Private Sub New empty procedure when 
your class contains many fields' initializers: 

Public MinSize As Integer = 10 

Public MaxSize As Integer = 1000 

' ...(other fields with initializers) 

The compiler generates hidden assignments at the beginning of each 
constructor to ensure that all fields contain the correct initial value 
when the constructor runs. If you have 20 field initializers and 10 
constructors, then your class contains as many as 200 hidden 
assignments that waste bytes in memory and on disk. If you define 
a dummy parameterless private constructor and have all the public 
constructors call it, then the compiler adds the 20 hidden statements 
only to the private constructor. You can see the code the compiler 
creates in each case by running the resulting executable file through 
the Microsoft Intermediate Language Disassembler (ILDASM). 

Another good occasion for using a private constructor occurs 
when clients should create instances of the class only through a 
shared function, which works as the factory method for the class. 
A shared method lets you run some code before creating a new 
instance of the class — for example, to check whether an object 
with the same properties is in an object pool that you manage 
internally. You can't implement this technique with a regular 
constructor, whose code runs only when a new instance is running 
already (download Listing 1). 

You see OOP's real power when you derive a new class from 
another, simpler class. The derived class inherits all the base class's 
fields, properties, methods, events, and interfaces automatically, so 
you can focus on only the members you want to add to the derived 
class: 

Class Person 

Public FirstName As String 

Public LastName As String 

Function Compl eteNamet ) As String 
Return FirstName & " " & LastName 

End Function 
End Class 
Class Customer 

Inherits Person 

' a new field and a new method 

Public Title As String 

Function ReverseNamef ) As String 

Return LastName & " , " & FirstName 
End Function 
End Class 

Even better, you can override a property or method in the base 
class if you expect your derived class to behave differently. For 
example, you might want the Customer.CompleteName method to 
return a string in the "Mr. John Doe" format. You must do two 
things to override a member: Mark the base class's member as 
Overridable to make it a virtual member, and mark the derived 
class's member with the Overrides keyword: 

' in Person class 

Overridable Function Compl eteNamet ) As String 
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' ... (as before) 
End Function 

' in Customer class 
Overrides Function Compl eteName( ) _ 
As String 

Return Title & " " & FirstName _ 
& " "& tastName 
End Function 



Reuse Code in Base Class 

Visual Studio .NET offers a great shortcut 
for writing the code of an overridden mem- 
ber in a derived class: Select the (Overrides) 
element under the class name in the left- 
most combo box above the editor window, 
then select which member you want to 
override in the right-most combo box (see 
Figure 1). You don't need the Overridable 



keyword in the derived class, because over- 
ridden methods are themselves overridable. 
If you want to stop further overriding of that 
method for some reason, you must flag it 
with the NotOverridable keyword: 

' derived classes can't override this 
NotOverridable Overrides Function _ 
CompleteNamet )As String 

End Function 

The code in a redefined method often 
benefits from reusing code in the base class's 
method — for example, to insert statements 
that run before or after the code in the 
original method. Continuing the previous 
example, the Customer. CompleteName 
method can reuse the code in Person. - 
CompleteName with the help of the MyBase 
keyword: 

' in Customer class 
Overrides Function CompleteNamet) _ 
As String 

Return Title & " " & 
MyBase. Compl eteName( ) 
End Function 

You can always assign an object to a 
variable whose type is the object's base class. 
For example, you can always assign a Cus- 
tomer object to a Person variable: 

Dim cust As New Customer( ) 
cust. Title = "Mr. " 
cust . Fi rstName = "John " 
cust . LastName = "Doe" 
Dim pers As Person - cust 

(Incidentally, this rule explains why you can 
assign any object to an Object variable.) The 
assignment in the opposite direction might 
fail at run time if the pers variable doesn't 
point to a Customer object, so you must use 
the CType or DirectCast operator to tell the 
compiler explicitly that you know the as- 
signment is legal: 

Dim cust2 As Customer - _ 
Di rectCast(pers , Customer) 

The main difference between CType and 
DirectCast is that DirectCast can only casta 
value to a different reference type, whereas 
the CType can also convert a value to a 
different type. CType also works with value 
types. Regardless of the operator you use, 
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.NET throws an exception if the source variable points to an object 
whose type isn't compatible with the target variable. 

Assigning an object to a variable of a different type doesn't affect 
the object's nature. For example, calling an overridden method 
through a base class's variable invokes the derived class's implemen- 
tation, not the base class's method: 

' pers points to a Customer, so this 
' statement displays "Mr. John Doe" 
Console.Writetpers . Compl eteName ) 



Inheritance is the most common way to 
implement polymorphism in a .NET appli- 
cation. For example, say you have an array or 
a collection that contains Person objects, 
Customer objects, and other objects that 
inherit from Person. Each object reacts by 
running the code inside its own implemen- 
tation of the CompleteName method in this 
loop: 



the base class's constructor if you define other constructors with 
parameters in the derived class, because the compiler can do it for 
you. Second, you must define at least one constructor in the 
derived class to make it creatable if the base class doesn't have a 
parameterless constructor. The first executable statement of all the 
constructors in the derived class must invoke a constructor in the 
base class explicitly. 

I'll show you how these points apply to a practical case. The 
Person class has an implicit default constructor, so you don't need 
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Dim p As Person 

For Each p in personCol 1 ecti on 

Console.WriteLine(p.CompleteName) 

Next 

Here's a performance tip: Invoking an 
overridable (virtual) member is slower than 
calling a nonvirtual one. Besides, the Just in 
Time (JIT) compiler can't optimize a call to 
a virtual method by in-lining the method — 
that is, by moving its code inside the calling 
procedure to avoid the overhead of making 
the call and passing arguments. So you 
shouldn't flag a method as overridable un- 
less you foresee the need to override it in 
derived classes. 

Leverage .NET Inheritance 

You must use both the Override and Over- 
loads keywords if you override a member 
that's overloaded in the base class. Ifyou add 
a member that has the same name as a 
member in the base class but a different 
argument signature, you must specify the 
Overloads keyword but not the Overrides 
keyword: You override a member only if 
both its name and signature match those of 
a method in the base class. 

A derived class inherits all its base class's 
members, with the exception of construc- 
tors. You must implement explicitly all the 
constructors the derived class needs to ex- 
pose, and adhere to two rules. First, the 
compiler can create an implicit default 
constructor in the derived class only if the 
base class has an implicit or explicit param- 
eterless constructor. You don't need to call 
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to define a constructor in the Customer class because the VB.NET 
compiler creates a default constructor for you. Moreover, a con- 
structor with parameters to the Customer class doesn't have to 
invoke a constructor in the base class explicitly because, again, the 
compiler adds such a call automatically. But suppose the Person 
class exposes a nondefault constructor (whose presence tells the 
compiler not to create the implicit parameterless constructor): 

' in the Person class 

Sub NewtByVal firstName As String, _ 

ByVal lastName As String) 

Me. FirstName = firstName 

Me . LastName = 1 astName 
End Sub 

In this case, the Customer class must contain explicitly a constructor 
whose first statement is a call to MyBase.New. The constructors in 
the base class and in the derived classes don't necessarily take the 
same set of arguments: 

' in the Customer class 

Sub New(ByVal title As String, _ 

ByVal firstName As String, _ 

ByVal lastName As String) 

MyBase. New(f i rstN?me . lastName) 

Me. Title = title 
End Sub 

The derived class must be able to access at least one constructor 
in the base class, a requirement that has a couple of interesting 
consequences. First, you can't inherit a class that has only Friend 
constructors from a class in a different assembly. Second, you can't 
inherit at all from a class that has only Private constructors. (More 
precisely, only its nested classes can inherit from it.) The preferred 
way to define a sealed class — a class that can't be inherited from — 
is to flag it with the Notlnheritable keyword: 

Not I nheri tabl e Class Person 

End Class tm> loanMka no wot tboru - 

As you might expect, a sealed class can't contain overridable 
members. 

Shadow Base Class's Members 

If you're inheriting from a class you didn't author, you must be 
prepared to cope with this problem: The base class can be extended 
later with a member that has the same name as a member your 
derived class exposes already. In the code example, this would occur 
if a new version of the Person class adds a ReverseName method. 
When you recompile the Customer class, the VB.NET compiler 
issues the warning: "function 'ReverseName' conflicts with func- 
tion 'ReverseName' in the base class 'Person' and so should be 
declared 'Shadows.'" 

As the message suggests, you can decorate the Customer.- 
ReverseName method with the Shadows keyword to make it clear 
that this method doesn't override the Person. ReverseName method 



and get rid of the compiler warning: 

Shadows Function ReverseName! ) As String 
Return LastName & " . " & FirstName 

End Function 

You can use the Shadows keyword with any type of member, 
including nested classes. When a member shadows a member with 
same name in the base class — with or without an explicit Shadows 
keyword — you can't access it through a base-class variable. For 
example, this code behaves differently from what you might 
expect: 

Dim cust As New CustomerO 

init cust properties... 
Dim pers As Person = cust 
' next line invokes the ReverseName 
' in Person class, not in Customer 
Consol e. Write (pers .ReverseName) 

Remember: Regardless of whether you use the Shadows keyword, a 
method you don't flag with the Overrides keyword hides all the 
overloaded methods with the same name defined in the base class, 
not only the one that has the same argument signature. 

I suggest that you use shadowing only as a last resort, because it 
tends to make a class's behavior more confusing. Never define a 
method that shadows a method that exists already in the base class, 
and try to use member names that the base class's author is unlikely 
to add in a subsequent version. 

The constructor's scope 
has serious implications 
on the class's behavior. 

A base class can also define members with the Protected scope 
qualifier. A protected member is a member that's visible only to its 
class and its inherited classes (including inherited classes defined in 
different assemblies). For example, all .NET classes inherit the 
Finalize and MemberwiseClone protected methods from Sys- 
tem. Object. 

The .NET runtime invokes the Finalize method when the object 
is about to be removed from the managed heap. You shouldn't 
invoke this method yourself, but you can override it to perform 
special cleanup operations when the object is finalized, such as 
releasing operating-system handles that you acquired with a call to 
a Windows API function. 

The MemberwiseClone method returns a copy of the running 
object; you should never override it. This method is especially 
helpful for implementing the ICloneable interface and its only 
member, Clone: 

Class Person 

Implements ICloneable 
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Function CloneO As Object 
Implements IC1 oneabl e . CI one 
Return Me.Memberwi seCl one( ) 
End Function 
End Class 



You can also clone the runningobject by creating a new instance 
and setting its properties, but the MemberwiseClone is more 
efficient because it makes a straight copy of the memory your object 
uses. Keep in mind that the MemberwiseClone method returns a 




shallow copy of your object: It clones its fields but doesn't clone 
objects these fields point to. 

Add Flexibility With Protected Methods 

You should never declare protected fields, because they would 
prevent you from changing your base class's internal implementa- 
tion in a later version. Instead, you should declare protected 
properties that wrap private fields, so that you can change the 
property procedure's implementation without affecting existing 
derived classes. 

Protected methods are especially useful 

when you want to provide inheritors with a 
way to change your base class's behavior. For 
example, suppose you have a Report class 
that prints a report: 

Class Report 
Sub Printt ) 

' ... print the header . . . 
' . . .print the body. . . 
' ...print the footer . . . 
End Sub 
End Class 

The problem with this naive implementa- 
tion is that it offers no hooks for customiz- 
ing the Print method's behavior: A derived 
class can either inherit it as-is or override it 
completely by providing all-new code that 
prints the header, the body, and the footer. 
A better approach relies on auxiliary pro- 
tected methods to deliver a more flexible 
solution: 

Sub Printt ) 
OnHeadert ) 
OnBody< ) 
OnFooter( ) 
End Sub 

Protected Overridable Sub OnHeadert) 

' . . . pri nt the header . . . 
End Sub 

Protected Overridable Sub OnBodyt) 

' . . .print the body. . . 
End Sub 

Protected Overridable Sub OnFootert) 

' ...print the footer . . . 
End Sub 

A derived class can now override only the 
report's header, footer, or body. For ex- 
ample, you can suppress footers altogether 
wirh an overridden OnFooter method that 
contains no executable code: 

Class NoFooterReport 
Inherits Report 

Protected Overrides Sub OnFootert) 
Continued on page 29. 
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Continued from page 28. 

' prints nothing here 
End Sub 
End Class 

Protected methods meant to be overridden in derived classes are 
typically named Onxxxx. For example, the System.Windows.- 
Forms.Form class exposes many Onxxxx overridable protected 
methods that let you customize your forms' behavior. You can 
process all the messages that Windows sends to a form, including 
messages the base Form class doesn't translate to events (such as 
those generated by mouse actions on the form's title bar), by 
overriding the OnWndProc method. This technique offers a way to 
subclass your form that's safer and simpler than the corresponding 
VB6 technique. 

Speaking of events, you can't override the base class's implemen- 
tation of an event as simply as you override a method or property, 
because you can't apply the Overridable and Overrides keywords to 
events. You must wrap the RaiseEvent statement in a protected 
overridable method, which is typically named Oneventname, to let 
derived classes redefine the event in the base class: 

' base class with re-definable event 
Class Report 

Event Sub EndOfReporttpages As Short) 
Sub Print! ) 

' ...same code as before... 
OnEndOfReport(numOfPages) 
End Sub 

Protected Overridable Sub _ 

EndOfReporttpages As Short) 

RaiseEvent EndOf Report ( pages ) 
End Sub 
End Class 

A derived class can override rhe OnEndOfReport method to take 
control of the EndOfReport event — for example, to append a grand 
total for the report. The derived class can then fire the original event 
by calling the MyBase. OnEndOfReport method, or cancel the 
event by omitting this call: 

' a class that redefines the event 
Class ReportWithTotal 
Inherits Report 
Protected Overrides Sub _ 
EndOfReporttpages As Short) 
' ... print the grand total... 
' cancel the event if pages=l 
If pages > 1 Then 

' this fires the event 
My Base. EndOfReport (pages) 
End If 
End Sub 
End Class 

You must become familiar with two more VB.NET keywords: 
Mustlnherit and MustOverride. You apply the Mustlnherit key- 
word to abstract classes — that is, classes that can't be instantiated and 
can work only as a base class for other classes. You apply the 



MustOverride keyword to abstract methods — methods that lack a 
concrete implementation and that must be overridden in inherited 
classes. The two keywords are related, in that a class containing a 
MustOverride method is an abstract class and you must declare it 
with the Mustlnherit keyword. (The opposite isn't true, though; 
you can have an abstract class that contains no abstract methods.) 

You usually use abstract classes to model generic or conceptual 
real-world entities that don't correspond to specific objects. For 
example, say you're creating a computer-aided design (CAD)-like 
application that works with geometrical shapes. It makes sense to 
abstract the shape concept and define a Shape class that contains the 
code all actual shapes share — for example, their X,Ycoordinates and 
the ability to be moved to a different position: 

Mustlnherit Class Shape 
Public X, Y As Double 
Sub Movetdx As Double, dy As Double) 

' move the shape and redraw it 

X += dx: Y += dy 

Me . Draw! ) 
End Sub 

' notice that no End Sub is used 
MustOverride Sub DrawO 
End Class 

Class Square: Inherits Shape 
Overrides Sub DrawO 

' ...(code to draw a square) 
End Sub 

End Class 

The Shape class must contain the definition of the abstract Draw 
method (otherwise, it won't compile), but only a concrete class such 
as Square can (and must) provide the actual implementation for that 
method. 

OOP is a complex topic, and it takes a while to take full 
advantage of its features and understand all its implications. I've 
condensed a lot of information and given you some practical design 
and performance tips at the same time. Start practicing what you've 
read in these pages and in VB.NET manuals, and you'll discover an 
entirely new and exciting way to build robust, flexible, and easily 
maintainable applications, vsm 



Francesco Balena is the author of Programming Microsoft Visual 
Basic 6.0 and Programming Microsoft Visual Basic .NE T (Microsoft 
Press), speaks at VSLive! and other developer conferences, and 
teaches VB.NET classes for Wintellect (www.wintellect.com). He's 
the principal of Code Architects Sri, an Italian company specializing in 
.NET development, and the founder of www.vb2themax.com. Reach 
him at fbalena@vb2themax.com. 
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Additional Resources 

• Chapter 4, "Class Fundamentals," Chapter 5, "Inheritance," 
and Chapters, "Interfaces and Delegates," of Programming 
Microsoft Visual Basic .NETby Francesco Balena [Microsoft 
Press, 2002, ISBN: 0735613753] 

• These topics in the .NET SDK documentation: inheritance, 
polymorphism, encapsulation, type, System. Object, 
Overridable, Overrides, Shadows, Friend, Protected, 
Notlnheritable, Mustlnherit, and MustOverride 
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VB .NET OOP for the VB 6 Developer 
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expose in text and bound controls. Since Web bound controls are 
not updatable, well show you how to save data in the Session 
cache and post changes to the database or DataSet and get those 
updates sent to the database. 
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Keith Pleas, Guided Design 
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can do with the .NET Framework such as multi- 
threading, Windows services, diagnostics (performance counters and 
event logs), inheritance, delegates, attributes, and structured 
exception handling. In this session well discuss how you can utilize 
each of these framework features while demonstrating code, and 
leave you with a clear understanding of the capabilities of the .NET 
Framework and how to exploit its features using Visual Basic .NET. 
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The possibility of creating user-defined functions in 
SQL Server 2000 represents exciting possibilities to 
any SQL Server developer. Most systems don't exploit this interest- 
ing feature to its maximum, and this session will provide innova- 
tive examples on how to use them to solve specific programming 
problems. We will look at how to work around some limitations of 
UDFs, and how to convert views and stored procedures into UDFs. 

Build Transactional ASP.NET Pages sgm 
and Web Services *» 
Juval Lowy, IDesign 

Both ASP.NET Web pages and ASP.NET Web services 
have native support for transactions crucial for 
maintaining app consistency. This talk presents the essential aspects 
of transactional programming and then demonstrates how ASP.NET, 
AD0.NET and Web services take advantage of transactions, as well 
providing design guidelines for the interaction between ASP.NET 
a transactional middle tier. 
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Attributes to dynamically load assemblies, discover useful objects 
and instantiate them; use Events to notify remote clients of new 
object types that are available; use WeakReferences to allow event- 
firing on objects that could be discarded without warning; and use 
Remoting to let Clients request objects from a remote broker across 
machine boundaries. 
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uses the most suitable data type for the task at hand. 
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Data types weren't particularly excitingprior 
to .NET, because the data types in previ- 
ous versions of Visual Basic don't do anything 
except hold data. Now, each .NET data type has 
a rich set of properties and methods built into it. 
I'll show you how to take advantage of these new 
features by sharing some specifics about .NET 
data types and explaining how to use each data 
type effectively — including using integers as 
bitwise flags. 

Data types are called primitive types in the 
VB.NET language specification and simple types 
in the C# language specification. This group of 
types has special behaviors in both languages, 



by Kathleen Dollard 

including aliases and operators. Aliases map a 
language-specific name to the underlying .NET 
data type; using the alias is exactly the same as 
using the corresponding System type. These are 
also the only types you can write as literals, and 
constants must be of these types. VB.NET limits 
its data types to those in the Common Language 
Specification (CLS), which defines the data types 
that can be used across all .NET languages. C# 
includes additional data types, such as unsigned 
integers. I ll cover only data types in the CLS. 

Most data types are ValueTypes, which are 
designed for rapid access (see Figure 1 and the 
sidebar, "Beef Up Performance With Value- 
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Figure 1 ValueTypes Provide Speed. .NET data types other than String are ValueTypes providing 
stack-based access for high performance. They also inherit from System.Object to provide a single 
class that can represent anything you create in any .NET language. 
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Types"). You can use properties and methods on any instance of 
data types, including literals: 

stringValue - 3.ToString() 
stringValue = "TestStri ng" . ToLower( ) 
intValue = Integer. MaxVal ue 

Data types even support shared properties, methods, and interfaces, 
including IComparable, IConvertible, and IFormattable. 

Data types in the CLS include four integers, two floating points, 
Decimal, DateTime, Char, String, and Boolean (for a summary of 
these data types and suggestions for when to use each one, download 
Table 1 from the VXAfWeb site; see the Go Online box for details). 
They aren't merely compatible across languages, but are exactly the 
same type in every .NET language, regardless of their language- 
specific aliases. Unsigned integers are an example of a data type for 
which C# defines operators and aliases, and VB.NET doesn't 
(because it discourages using types beyond the CLS). If you need to 
use a C# function that returns an unsigned integer from VB.NET, 
declare your receiving variable as a system unsigned integer such as 
System. UIntl6. You'll have your data but can't do much with it 
except pass it on to another C# method or convert it using a system 
conversion method such as Convert.ToInt32. 

The four integer types are Byte, Intl6, Int32, and Int64. Which 
type you select depends on its efficiency in the CPU, how big your 
values are, and, occasionally, the integer's size in memory. Integers 
are by far the most efficient data type for counters or math. Your 
computer's CPU is designed to do integer calculations quickly, and 
current Windows OSs are optimized for 32-bit math. Smaller 
integers are widened during processing and aren't more efficient 
than a 32-bit integer. A 64-bit integer is split under the hood before 
the processor handles it, so avoid using Int64 unless you're working 
with extremely large integers. 

Integers support two types of division. Normal division (/) of an 
integer and any number (including another integer) results in a 
Double that includes the fractional part. In contrast, you can 
perform Integer division (\) only between integers, and it results in 
an integer with the fractional part truncated. Integer division is 
significantly faster than normal division. 

Exceptions Can Happen 

.NET strong data typing builds in a great deal of protection by 
raising compiler errors that are easy to fix, rather than tough-to-solve 
runtime logic problems. However, some runtime exceptions still 
occur, such as overflows. This code compiles, but it throws a 
runtime exception because the result is too large for a 16-bit signed 
integer: 

Dim i As Intl6 = 30000 
Dim j As Intl6 - 4 
Dim result As Intl6 
result = i * j 

You can also use an integer to hold a series of bit flags, referred to as 
a bit field. This allows you to combine several true/false values into 
a compact number. An Enum, or enumeration, is a special type of 



integer, and the .NET Framework provides support for bit fields in 
the enumerations' System.FIags attribute (download Listing 1). 
When you use the Flags attribute, you must also skip zero and define 
the values as powers of two (1 , 2, 4, 8, and so on). Then you can use 
each language's bitwise operators. In C#, bitwise and is & and or 
is | . In VB.NET, they are And and Or. Use bitwise or to combine 
values, such as for assignments. Use bitwise and to see if a bit is set: 
If the result isn't zero, the bit is set. Enum support for True/False 
flags allows you to use a readable syntax that IntelliSense supports. 

Unlike integers, fractional numbers are difficult to represent in 
a computer. The on/ off switches that digital computers rely on can't 
represent some numbers, such as 0.01, exactly. Programmers have 
solved this problem for decades by using complex floating-point 
number techniques. Although floating-point math is fast, it relies on 
(exceptionally good) approximations and isn't always exact in the 
last digit when you store and retrieve data. This is rarely a problem 
if the type has more precision than the application requires. How- 
ever, if the error is at a value close to the rounding point (such as .005 
for U.S. dollars), an error of 1 in the rounded position (such as a one- 
cent error) can occur. The frequency with which this happens 
depends on the numbers' size relative to the type's precision. Single 
is probably large enough, but not precise enough for your data. This 
makes Double the standard fractional data type. 

Some applications can't tolerate floating-point math's inherent 
rounding errors. .NET introduces the Decimal type to address this 
issue. A Decimal type's degree of precision is hard to comprehend. 

^ Beef Up Performance With ValueTypes ^ 

You might have heard that everything in .NET is an object — this 
is both true and untrue. It's true that everything inherits from 
System. Object. The System. Object common base gives you a 
class that can hold absolutely anything you can create in any .NET 
language. This includes instances of any system or user-defined 
class, any system or user-defined structure, and any enum, 
delegate, or data type. 

In other languages, a common object base often implies that 
everything is a reference type with a pointer in near memory (also 
called the stack) that points to data residing on the heap. The heap 
is designed to store larger amounts of data, but with a perfor- 
mance cost. .NET includes an abstract type, inherited from 
System. Object, called ValueType that provides stack-based stor- 
age. This allows .NET to be as fast as languages with stack-based 
data handling, while maintaining the flexibility of the common 
base class — System. Object. There are no pointers to ValueTypes, 
and a copy is made each time you assign the value. Data types 
other than String are ValueTypes that reside on the stack; enums 
and structures are also ValueTypes. 

Treating a ValueType as an object becomes difficult once you 
store it on the stack. To solve this problem, NET builds a 
reference type (wrapper object) and moves the data itself to the 
heap when necessary. This is called boxing, and the return step 
is unboxing. You box when you cast — explicitly or implicitly — to 
System. Object. Boxing incurs a performance penalty, so avoid 
casting to System. Object when you don't need to. 
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It could record the exact number of cells in every human body on 
Earth 100,000 times if you could count them accurately. It's 
guaranteed not to have rounding errors on storage and retrieval, but 
it uses a much slower mechanism than floating-point math. If your 
application must be correct to the displayed decimal point (such as 
the penny), the Decimal data type is appropriate, particularly if 
you're using large values. 

Don't expect any data type to solve every rounding problem. No 
matter how many decimal places you use, .3333 + .3333 = .6666, 
while 2/3 rounds to .6667: 

If ((1/3) + (1/3) = (2/3)) Then 

' This will never be hit 
End If 

Check the absolute value of the difference between numbers when 
you need to compare them. For example, you can rewrite the 
previous code as this: 

If Abs(((l/3) + (1/3)) - (2/3)) < _ 
.0001 Then 

' This will be hit every time 
End If 

Rounding is less desirable because differences near the rounding 



point (the digit 5) can change the outcome, resulting in sporadic 
logic errors. 

Don't Think of Booleans as Numbers 

In contrast to the preceding types, Booleans aren't treated as 
numeric values in .NET languages. You should think of True as 
simply True, rather than as 1 , - 1 , or "not zero." However, you might 
want occasionally to convert a Boolean to a numeric, perhaps to 
store it in a file. The VB.NET method Clnt(True) returns -1, and 
System. Convert.ToInt32() returns + 1 . The reason for this inconsis- 
tency is simple. In past versions of Visual Basic, you could use 
Booleans in bitwise operations, and True had all bits set on, which 
happens to be -1 for a signed integer (255 for a Byte). The CInt 
behavior avoids a huge set of conversion problems because you use 
it for implicit conversions when Option Strict is Off. The value of 
a Boolean converted to an integer matters rarely, except when you 
read and write data to files that use integers for Booleans. In this case, 
read in the data using any conversion function (such as Convert.- 
ToBoolean), because all the Boolean conversions translate "not 
zero" to True. 

If you read or write files containing COM-compatible dates, you 
must use theToOADate and FromOADate methods. System. Date- 
Time uses a new internal format that stores dates as the number of 
100-nanosecond increments (ticks) elapsed since 1/1/0001 in the 
Gregorian calendar. This approach's benefits include high precision 
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and the ability to express this moment in time in any .NET- 
supported calendar. DateTime supports a rich set of methods, 
including extensive date arithmetic using the TimeSpan structure 
for describing a time interval. 

The rich set of methods .NET provides extends to the two 
character types: System.Char and System. String. It does this largely 
through the wonderful world of Unicode. You can work with strings 
in any major written language using a well-designed, feature-rich 
character set. Unicode provides metadata, including categories for 
each character. These categories are a bit arcane, so System.Char also 
provides easy-to-use Boolean methods such as IsLetter, IsUpper, 
and IsPunctuation. You can use the GetNumericValue method to 
convert digits to their numeric values. Unicode includes Roman 
numerals, so you can even do arithmetic with them. 

You can combine Chars into arrays and strings. Strings are 
reference types that behave like ValueTypes. A string is an object 
that's copied when you make any change to it, leaving the original 
string immutable (unchangeable): 



Dim si As String = "a" 
Dim s2 As String = si 
s2 = "b" 



'si & s2 are "a" 
'si is still "b" 



Immutability makes operations other than changing a string's 
value quite fast. Changing a string is considerably slower, so use 
Sysrem.Text.StringBuilder when you build a string by concatenat- 
ing values across many lines of code. You must create the StringBuilder 
object, so don't use this technique when you do a single line 
concatenation: 

s = si & s2 & s3 & s4 & s5 

Use it only when you have a multistep concatenation: 

Dim sb As System . Text . St ri ngBui 1 der 
sb. Appendt si ) 
sb.Append(s2 & s3) 
sb. Append(s4) 

String is the only data type without a default value. To use 
methods or properties of a string that you aren't certain is initialized, 
use code like this: 

If Not si Is Nothing AndAlso 
si .Trim = " " Then 

You also use this trick in the condition clause when you set debugger 
breakpoints. C# and VB.NET react differently to noninitialized 
strings. This VB.NET code prints both "si is nothing" and "si is 
empty," even with Option Strict On: 

Dim si As String 

If si Is Nothing Then 

Debug. Wri teLi net "si is nothing") 
End If 

If si = "" Then 

Debug. Wri teLi net "si is empty") 
End If 



The C# compiler finds the noninitialized string and raises a com- 
piler error: 

string si; 

if tsl=="") Debug . Wri teLi net "empty ") ; 

The details I've provided illustrate key aspects of .NET data 
types and will help you select the best data type for each variable in 
your application. If you've got Option Strict turned on, the editor 
and compiler will help you learn more about how .NET types work 
together. The .NET Help includes a section on each data type with 
a list of properties and methods that I haven't repeated here. As you 
explore using .NET types in your own code, you'll discover addi- 
tional ways they help you solve programming challenges. 



Kathleen Dollard is an independent developer based in Fort Collins, 
Colo. She is a Microsoft MVP, enjoys speaking at conferences such as 
VSLive!, and is active in the Denver Microsoft Visual Studio .NET User 
Group. Reach her at kathleen@mvps.org. 
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Applied Microsoft .NET Framework Programming by Jeffrey 
Richter [Microsoft Press, 2002, ISBN: 0735614229] 
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Adding functionality without compro- 
mising usability has always been one of 
the great challenges of user-interface design. 
One way of doing this that's become popular 
on the Web is implementing collapsible pan- 
els — control-containing areas the user can hide 
and reveal at will. When closed, each panel 
maintains a small title bar and one small button 
for opening the panel. You can enhance Uls in 
your WinForms apps with similar elements 
that are even more versatile. 

We'll describe how to create a powerful 
WinForms composite control that implements 
a group of collapsible panels. The sample code 
provides a fully functional control that allows 
you to create flexible Uls (download the sample 
code from the VSM Web site; see the Go Online 
box for details). This control goes beyond the 
typical collapsible panels you see on the Web to 
manage the collective behavior of an aggregation 
of panels automatically. For example, when you 
set the control to its most space-conserving 
mode, opening any panel collapses any previ- 
ously opened panel automatically, always main- 
taining the minimum possible consumption of 
interface real estate. In another mode, panels 
autocollapse only if necessary for maintaining 
the maximum group size you specify. 

Get started building the composite control 
by creating a Windows Control Library. The 
project contains two distinct user controls: the 
CollapsingControl, which collapses and ex- 
pands a panel, and the GroupingControl, which 
can house one or more CollapsingControls. 
You'll create the CollapsingControl first (see 
Listing 1 ) . You must use the Designer attribute 
on the class to do this. 

You delimit attributes in C# with square 
brackets. The Designer attribute precedes the 
class declaration: 

[DesignerCSystem.Windows. Forms . Desi gn . 
ParentControl Desi gner, System. 



Design", typeoft System. 

Component Mod el . Design.IDesigner))] 

You can't add any controls to the Collapsing- 
Control without this attribute. (An alternate ap- 
proach is to subclass the Panel class. However, we 
chose not to take that approach, so that we could 
show you how to begin from scratch.) 

The CollapsingControl contains a panel 
whose docked property is set to Top. This panel 
contains a label and a linkLabel. You use the 
label to display the CollapsingControl's descrip- 
tion, and the linkLabel serves as the button a user 
clicks on to collapse («) and expand (») the 
control. Set the label's docked property to Fill, 
and set the linkLabel's docked property to Right. 

The collapsible control has two heights: the 
current height and the expanded height. You use 
a private field and public property to store and 
set these values. The Browsable attribute allows 
you to set the property from the Properties 
window in the VS.NET IDE, although using 




Figure 1 Group Collapsible Controls. The light- 
blue box is the GroupingControl, which contains 
three CollapsingControls. Each CollapsingControl 
contains linkLabels, although it could contain any 
kind of control. 
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this is somewhat superfluous because the Browsable attribute is true 
by default. However, use this code if you don 't want the property to 
be available from the Properties window: 

[System. Component Model . Brows a bl e 

(false)] 

Set the height of the collapsed control to the label's height. This 
minimum height could be a public exposed property as a future 
enhancement. The current implementation requires you to set the 
CollapsingControl's Heigh tExpanded property manually. You might 
wish to change this so the property is set automatically, but doing 
so could prevent you from setting the initial height of the control to 
the minimum height. The Opened property's setting determines 
whether a CollapsingControl should be set to Collapsed or Ex- 
panded (the default) in design time and at run time. 

Set the Caption 

The next step is setting the CollapsingControl's caption, which is 
the text the label displays. This step requires a workaround. You 
can't override a user control's Text property in C#; this is unfortu- 
nate, because you'd like to use the Text property to set the label's 
Text property in the control. If you try to workaround this by using 
the new operator on the Text property (this hides the base class's 
Text property), you encounter an interesting problem: Setting the 
Text property from the Properties window fails to generate the code 
to set this value. This would seem to suggest a bug/ feature within the 



IDE rather than with the language. (Strangely, the property is 
Overridable if you use VB.NET, which is especially troubling when 
you consider that the .NET Framework class library is supposed to 
be consistent across languages.) The only solution is to code the Text 
property initialization manually or use a different property name, 
such as Title, as the example code does. 

Your custom control inherits from the UserControl class, so now 
you're responsible for painting the border for the control. (This 
would have been unnecessary had we decided to inherit from the 
Panel class.) Put the code for drawing the border in the Paint event: 

e. Graph ics. Draw Rectangle(Sy st em. Drawing. 
Pens. Black, 0, 0, pageWidth - 1, 
pageHeight - 1 ): 

If this is all you do , the borders will repaint j ust fine. However, as you 
resize the control to make it larger, you'll see the old borders remain 
because an optimization in the painting of a control causes only 
newly uncovered areas to be painted. You can overcome this 
problem by using the Invalidate method, which you should call 
from the Resize event. This technique is similar to standard Win- 
dows API programming. 

You've now finished building the CollapsingControl. However, 
a single CollapsingControl used on its own provides only marginal 
utility. You realize the control's true value only when you use 
multiple CollapsingControls in conjunction with a GroupingControl 
(see Figure 1). The GroupingControl contains the logic to coordi- 



C# • Build a Collapsible Control 



using System; 

using System . Col 1 ecti ons ; 

using System. ComponentModel ; 

using System. Drawing; 

using System. Data; 

using System. Wi ndows . Forms ; 

namespace CollapsingControls 

1 

[Desi gnert "System. Windows . Forms . Desi gn . 

ParentControlDesigner.System.Design", 

typeof ( System. ComponentModel . Desi gn . 

IDesi gner ) ) ] 
public class CollapsingControl : 

System. Wi ndows .Forms. UserControl 



public delegate void 

ExpandedEventHandler( object sender, 

System. EventArgs e) ; 
public delegate void 

Col lapsedEventHandler( object sender, 

System. EventArgs e) ; 
public event ExpandedEventHandl er Expanded; 
public event Col 1 apsedEventHandl er 

Col 1 apsed ; 

private System. Wi ndows . Forms . Panel panel 1; 
private System. Wi ndows . Forms . Label labell; 
private System. Windows . Forms . Li nkLabel 

linkLabell; 
// Used to store the height of the control 
// when expanded 

private int hei ghtExpanded = 75; 
public Col 1 apsi ngControl ( ) 



Initial i zeComponent ( ) ; 

} 

#region Component Designer generated code 

public void Col 1 apseExpand( ) 

{ 

// If the current height is the same 
// as the expanded height then the 
// control should be collapsed 
if (this. Height != thi s . Hei ghtExpanded ) 

( 

Expandt ) ; 

} 

else 
1 

Col 1 apse( ) ; 



public void ExpandO 
( 

this. Height = thi s . Hei ghtExpanded ; 
this. linkLabell. Text = "«"; 
thi s . 1 i nkLabel 1 . BackCol or = 

System.Drawing. SystemCol ors . 

ActiveCaption; 
this. labell. BackColor = 

System. Drawing. SystemCol ors. 

Acti veCapti on ; 
this. linkLabell. LinkColor = 

System. Drawi ng . SystemCol ors . 

Acti veCapti onText : 
thi s . 1 abel 1 . ForeCol or = 

System. Drawi ng . SystemCol ors . 

Acti veCapti onText ; 

Continued on page 38. 



Listing 1 The CollapsingControl class Inherits from UserControl. This isn't the complete class; it omits the Component Designer-generated 
code region. 
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Continued from page 37. 

II Raise the Event 

if (thi s . Expanded != null) 

I 

Expanded! thi s , new 
System. EventArgs( ) ) ; 



public void Collapsed 



this. Height = thi s . 1 abel 1 . Hei ght +2; 
this. linkLabell. Text = ">>"; 
thi s . 1 i nkLabel 1 . BackCol or = 

System.Drawing. SystemCol ors . 

Inacti veCapti on ; 
thi s . 1 abel 1 . BackCol or = 

System.Drawing. SystemCol ors . 

InactiveCaption; 
this . 1 inkLabel 1 . Li nkCol or = 

System. Or awi ng .SystemCol ors . 

Inacti veCaptionText; 
thi s . 1 abel 1 . ForeCol or = 

System. Drawing . SystemCol ors . 

Inacti veCapti onText ; 

// Raise the event 

if (this. Collapsed !■= null ) 

( 

Collapsed (this, new 
System. EventArgs( ) ) ; 



// This is the code for the << | >> link on 
// the control 

private void 1 i nkLabel l_LinkCl i ckedlobject 
sender. System. Wi ndows . Forms . 
Li nkLabel Li nkCl i ckedEventArgs e) I 
this.CollapseExpand (); 

I 

private void Col 1 apsi ngPanel_Pai nt (object 
sender, System. Wi ndows . Forms . 
PaintEventArgs e) 

I 

short pageTop = ( short )( thi s . Top ) : 
short pageBottom = ( short ) (thi s . Bottom) : 
short pageHeight - ( short) (thi s . Hei ght ) ; 
short pageLeft = ( short ) (thi s . Left ) ; 
short pageRight = (shortXthis. Right) ; 
short pageWidth = ( short ) (thi s .Width) ; 

e. Graphics. Clear( System. Draw ing. 

SystemCol ors .Control LightLight) ; 
e . Graphi cs . Fl ush (); 

e. Graph i cs . DrawRectangl e( System. Drawi ng. Pens . 
Black, 0, 0, pageWidth - 1, pageHeight - 1 
): 
1 

// When the control is resized, we must 

// invalidate the entire area for the 

// control so that it is repainted completely 

private void Col 1 apsi ngPanel_Resi ze( object 

sender. System. EventArgs e) I 

this. Invalidated; 

I 

[System. ComponentModel .Browsable (true)] 
publ i c new string Text 



get 
1 

return thi s . 1 abel 1 .Text ; 

1 

set 
( 

base. Text = value; 

this. labell. Text = value; 

I 

I 

public int Hei ghtExpanded 

{ 

get 

I 

return thi s . heightExpanded ; 

I 

set 



thi s . hei ghtExpanded = value; 



1 



I 



private bool opened = false; 

public bool Opened 

I 

get 
I 

return opened; 

1 

set 
I 

this. opened - value; 
if (value) 

this. Expand (); 
el se 

this. Col 1 apse ( ) ; 

I 

1 

private bool autoClose = false; 

public bool AutoClose 
I 

get 
I 

return autoClose; 

1 

set 
I 

thi s . autoCl ose = value; 

) 

I 

private int padding = 5; 

public int Padding 
1 

get 
f 

return padding; 

I 

set 
i 

padding = value; 



38 



VISUAL STUDIO MAGAZINE ■ February 2003 • www.visualstudiomagazine.com 



nate the opening and closing of the individual CollapsingControls. 
The sample GroupingControl isn't commercial-grade, but it dem- 
onstrates the available possibilities. The GroupingControl uses 
events to reposition each CollapsingControl as it's added to the 
GroupingControl (download Listing 2). 

The GroupingControl shifts the other CollapsingControls up- 
wards or downwards as each CollapsingControl is collapsed or 
expanded. Each CollapsingControl is separated from its neighbor 
by the margin you specify in the Padding property. The Padding 
property also provides a margin around the edges of the Grouping- 
Control. The GroupingControl allows only one CollapsingControl 
to be expanded if the other CollapsingControls in the Grouping- 
Control have the AutoClose property set to true. 

Even with the head start we've given you, you'll find developing 
custom controls such as the CollapsingControl a challenge, because 
you're likely to encounter intricacies you don't often come across in 
application development. Any team embarking on custom-control 
generation should have a few Microsoft Product Support! ^ervices 
incidents available. 

When you're ready to tackle another custom-control project, 
you might consider making several enhancements to turn the 
collapsible control you've just built into a commercial-quality 
control: You could improve the CollapsingControl's aesthetics by 
replacing the linkLabel with buttons containing images, by allowing 
the user to configure a control's collapsed height, or by animating 
Open and Close so the control opens and closes gradually. You 
could also enable Collapse All/ Expand All in the GroupingControl, 



as well as the ability to right-click on GroupingControl at design 
time and add the CollapsingControl. Another possibility is adding 
more AutoClose modes, such as a "Fit" mode in which controls 
collapse only when necessary to avoid overflow. (You can set the 
GroupControl's AutoScroll property to true for accommodating 
overflow.) You also could provide a means to change the order of the 
CollapsingControls within the GroupingControl. usw 

Douglas Gennetten has been an R&D engineer for Hewlett-Packard 
since 1978. After working in analog circuit design, imaging, color 
science, and user-interface design for HP's Digital Imaging Operation, 
Douglas is working on leveraging .NET technologies for HP with a 
focus on Ul design. Reach him at douglas.gennetten@hp.com. 

Jonathan Lurie has been developing software for numerous verti- 
cals, from accounting to law enforcement, since 1993. He writes, 
consults, and teaches software-development classes. He has a 
bachelor's degree in computer science and holds Java Programmer, 
IBM XML Developer, Solomon, MCT, MCDBA, MCSD, MCSE, and 
MSF Instructor certifications. Reachhimatjonathanlurie@hotmail.com. 
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Additional Resources 



• "VB .NET Custom Controls" by Budi Kurniawan: 
www.ondotnet.com/pub/a/dotnet/2002/06/03/custom.html 

• A tutorial on creating WinForms controls: 
http://samples.gotdotnet.com/quickstart/winforms/doc/ 
winformscreatingcontrols.aspx 
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Call WinForms on 
Multiple Threads 



Use the ISynchronizelnvoke interface to marshal calls to the correct thread, and put 
HTML on the clipboard that other apps can use. 



□ VB.NET 

□ SQL Server 2000 

□ ASP.NET 

□ XML 

& Other: 

VB5 

WinForms 

Go Online! 



Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these related 
resources. 

Download 

VS0302QA Download the code for 
this article. It includes the 
Synchronizer project, which 
contains a WinForms client that 
uses a Calculator class employing a 
generic implementation of 
ISynchronizelnvoke; and the 
HtmlClip project, which contains 
routines for sending HTMLto the 
clipboard. 

Discuss 

VS0302QA_D Discuss this article in 
the C# forum. 

Read More 

VS0302QA_T Read this article 
online. It includes Listing A. 

VB0106AP.T Ask the VB Pro, "Soup 
Up Office VBA," by Karl E. Peterson 

VB9812AP_TAsktheVB Pro, 
"Verifying Internet Access," by Karl 
E. Peterson 

VB9712AP.T Ask the VB Pro, "Copy 
and Paste with RichTextBox," by 
Karl E. Peterson 



Qt Call WinForms on 
Multiple Threads 

My WinForms application has a worker thread 
that updates the main windows. The documen- 
tation warns against calling the form on multiple 
threads (why?), and indeed, it crashes occasion- 
ally if I do. How can I call methods on the form 
from multiple threads? 



A: 



Every WinForms class that derives from the 
Control class (including Control) relies on the 
underlying Windows messages and on a message 
pump loop to process them. The message loop 
must have thread affinity, because messages to a 
window are delivered only to the thread that 
creates it. As a result, you can't call message- 
handling methods from multiple threads, even if 
you provide synchronization. Most of the plumb- 
ing is hidden from you, because WinForms use 
delegates to bind messages to event-handling 
methods. WinForms convert the Windows mes- 
sage to a delegate-based event, but you still must 
be aware that only the thread that creates the 
form can call its event-handling methods, be- 
cause of the primordial message loop. If you call 
such methods on your own thread, they'll ex- 
ecute on it instead of on the designated form 
thread. You can call any methods that you know 
aren't message handlers (such as your own cus- 
tom methods) from any thread. 

The Control class (and the derived classes) 
implement an interface dehned in the System.- 
ComponentModel namespace — ISynchronize- 
lnvoke — to address the problem of calling 
message-handling methods from multiple threads: 

public interface ISynchronizelnvoke 
{ 

object InvokeCDel egate 

method, object [] args); 
IAsyncResul t Beginlnvokel Delegate 



by Juval Lowy and Karl E. Peterson 



method, objectt] args); 
object EndInvoke( IAsyncResul t 

result): 
bool InvokeRequi red ( get : } 



ISynchronizelnvoke provides a generic, standard 
mechanism to invoke methods on objects resid- 
ing on other threads. For example, the client on 
threadTl can call ISynchronizelnvoke's Invoke() 
method on an object if the object implements 
ISynchronizelnvoke. The implementation of In- 
voke() blocks the calling thread, marshals the call 
to T2, executes the call on T2, marshals the 
returned values to Tl , then returns control to the 
calling client on Tl. Invoke() accepts a delegate 
targeting the method to invoke on T2, and a 
generic array of objects as parameters. 

The caller can also check the InvokeRequired 
property, because you can call ISynchronizeln- 
voke on the same thread as the one the caller tries 
to redirect the call to. The caller can call the object 
methods directly if InvokeRequired returns false. 

For example, suppose you want to invoke the 
Close method on some form from another thread. 
You can use the predefined Methodlnvoker del- 
egate, and call Invoke: 

Form form; 

/* obtain a reference to the form, 
then: */ 

ISynchronizelnvoke synchronizer; 
synchronizer = form; 

if(synchronizer. InvokeRequi red) 

I 

Methodlnvoker invoker = new 
Methodlnvoker(form.Close); 
synchronizer.Invoke(invoker.null); 

) 

el se 

form.CloseO; 
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( VB5.VB6 • Prepare HTML for the Clipboard 

— : : ; 



Public Function Html Descri bed( ByVal Fragment As _ 


nPos = InStr(l, Fragment, "</body", _• 


String) As String 


vbTextCompare) 


Dim Data As String 


Sel ect Case nPos 


Dim nPos As Long 


Case 


Const Description As String = _ 


Fragment = Fragment & FragmentEnd & _ 


" Vers i on : 1 . " & vbCrLf & _ 


vblrLf a </ body ></ ntm 1 > 


" StartHTML : aaaaaaaaaa " & vbCrLf & _ 


Case tlse 


EndH FML : dddddddddd & vbLrLt & _ 


Fragment = Left$( Fragment , nPos - 1) & _ 


" St a rt Fragment : cccccccccc & vbCrLf & _ 


FragmentEnd & Mi d$ ( Fragment , nPos) 


"EndFragment:dddddddddd" & vbCrLf 


End Select 


Const FragmentStart As String = _ 




"< ! - - Start Fragment- ->" 


' Build the HTML given the description, the 


Const FragmentEnd As String = _ 


' fragment, and the context. And, replace the 


"< ! - - EndFragment- ->" 


' offset placeholders in the description with 


Const Fmt As String = "0000000000" 


' values for the offsets of StartHMTL, 




' EndHTML, Sta rt Fragment , and EndFragment. 


' Add the starting and ending tags for the 


1 Offsets need to be zero-based when placed on 


' HTML fragment by looking for <body> tag. 


' clipboard, so subtract 1 


nPos = InStrd, Fragment, "<body", 


' from each before injecting. 


vbTextCompare) 


Data = Description & Fragment 


Select Case nPos 


Data - Repl acetData , "aaaaaaaaaa", _ 


Case 


Formats ( Len ( Descri pti on ) , Fmt)) 


Fragment = "<html ><body>" & vbCrLf & _ 


Data - Replace(Data, "bbbbbbbbbb" , 


FragmentStart & Fragment 


Format$(Len(0ata), Fmt)) 


Case Else 


nPos = InStrtData, FragmentStart) - 1 


nPos = InStrtnPos, Fragment, ">") 


Data = Repl ace( Data , "cccccccccc", _ 


If nPos > And nPos < Len ( Fragment ) _ 


Format$(nPos + Len( FragmentStart) , Fmt)) 


Then 


nPos - InStr(Data, FragmentEnd) - 1 


Fragment = Left$( Fragment , nPos) & 


Data = ReplacetData, "dddddddddd" , _ 


FragmentStart & Mi d$( Fragment , 


Format! ( nPos , Fmt)) 


nPos + 1) 


' Return attributed string. 


End If 


Html Descri bed - Data 


End Select 


End Function 



Listing 1 This routine is useful when you build the descriptive header string for an HTML fragment. If you pass an entire HTML document, the 
StartFragment tag is injected immediately following the <body> tag, and the EndFragment tag immediately before </body>. If you pass a 
fragment rather than a complete document, the routine makes it minimally whole by the addition of <html> and <body> tag sets. Use the 
ideas in this routine to construct variations for other scenarios easily. 



ISynchronizelnvoke isn't limited to Win- 
Forms. For example, a Calculator class pro- 
vides the Add() method for adding two 
numbers, and it implements ISynchronize- 
lnvoke. A client makes sure the method 
executes on the correct thread by calling 
ISynchronizelnvoke. Invoke() (download 
Listing A from the VSM Web site; see the 
Go Online box for details). 

You might want to be able to invoke the 
call asynchronously, because it's marshaled 
to a different thread from that of the caller. 
The BeginInvoke() and EndInvoke() meth- 
ods let you do this. You use these methods in 
accordance with the general .NET asyn- 
chronous programming model: Use Begin- 
Invoke() to dispatch the call, and End- 
Invoke() to wait or be notified about comple- 
tion and collect returned results. 

It's worth mentioning that ISynchronize- 
lnvoke methods aren't type-safe. A mis- 
match in type causes an exception to be 
thrown at run time, rather than a compila- 
tion error. Pay extra attention when you use 
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ISynchronizelnvoke, because the compiler 
won't be there for you. 

Implementing ISynchronizelnvoke re- 
quires you to use a delegate to invoke the 
method dynamically using late binding. 
Every delegate type provides the Dynamic- 
Invoke() method: 

public object DynamicInvoke(object[] 

args ) ; 

In the abstract, you must post the method 
delegate to the actual thread the object 
needs to run on, and have it call Dynamic- 
Invoke() on the delegate in InvokefJ and 
BeginInvoke(). Implementing ISynchron- 
izelnvoke is a nontrivial programming feat. 
The source files accompanying this article 
contain a helper class called Synchronizer 
and a test application demonstrating how 
the Calculator class in Listing A can imple- 
ment ISynchronizelnvoke using the Syn- 
chronizer class (download the source code). 
Synchronizer is a generic implementation 

™.visualstudiomagazine.com 



of ISynchronizelnvoke. You can use Syn- 
chronizer as-is by either deriving from it or 
containing it as a member object, then 
delegating your implementation of ISyn- 
chronizelnvoke to it. 

The key element of implementing Syn- 
chronizer is using a nested class called Work- 
erThread. WorkerThread has a queue of 
work items. Workltem is a class containing 
the method delegate and the parameters. 
Both Invoke() and BeginlnvokeO add a work- 
item instance to the queue. WorkerThread 
creates a .NET worker thread, which moni- 
tors the work-item queue. When the queue 
has items, the worker thread retrieves them, 
then calls DynamicInvokeO on the method. 
-J.L. 

Q: Work With HTML and 
the Clipboard 

My application needs to place HTML on 
the clipboard, but I can't figure out how to 
do this so that other applications under- 
stand that's what it is. I've seen references to 
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the HTML Clipboard Format (CF_HTML), but I can't find the 
definition for that constant. How should I proceed? 

A: 

Using the CF_HTML clipboard format with the Windows clip- 
board is a bit confusing, in part because it's not a native clipboard 
format; it's a registered format, so it isn't a constant at all, because its 
value differs from system to system. You can obtain registered 
clipboard-format values with a simple API call — RegisterClip- 
boardFormat. The first time this function is called with a given 
string, it returns a unique number in the range C000-FFFF. Each 
subsequent call that any process running on the system makes 
returns the same value. The magic string to use for this format is 
"HTML Format": 

Private Declare Function _ 
Regi sterCl i pboa rd Format 
Lib "user32" _ 

Alias "Regi sterCl i pboardFormatA" _ 
(ByVal IpString As String) As Long 
Dim CFJTML As Long 

Const RegHtml As String = "HTML Format" 
CFJTML = _ 

Regi sterCl i pboa rd Forma t( RegHtml ) 



a 



?nly the thread that 
creates the form can call 
its event-handling 
methods, because of the 
primordial message loop. 

You must construct a descriptive header and prepend it to the 
data before you can place your HTML data onto the clipboard. This 
header provides other applications with the description's version 
information, with offsets within the data where the HTML starts 
and stops, and with information about where the actual selection 
begins and ends. Conceptualize the selection by considering a user 
who might select a portion of an HTML document or even an 
element (such as a few rows in a table). Other portions of the page 
(such as inline style definitions) might be required to render the 
selection fully. You likely must supply more than the raw selection 
to put HTML on the clipboard in its full context. A sample header 
might look like this: 

Versi on : 1 . 
StartHTML:000000258 
EndHTML: 000001491 
Start Fragment : 000001 172 
EndFragment:000001411 

Applications use the StartFragment and EndFragment attributes 
to determine which data to paste, and they might or might not use the 



remaining HTML to help format the selected portion. You must 
inject HTML comments into the data to identify the selected area 
further. Obviously, you must do this before you build the final header, 
because the offsets won't be stable otherwise. The opening/closing 
comment tags for the selected data are "<! — StartFragment — >" and 
"<! — EndFragment — >", respectively (see Listing 1). 

I don't have enough room here to detail all of this header's 
aspects, so I'll hit a few highlights and refer you to the sample code 
and further reading (see Additional Resources). You must keep 
several critical points in mind. The offsets listed in the header are 
zero-based, so you must adjust your string-manipulation routines 
accordingly. Also, if you're reading as well as writing these headers, 
you must assume that the number of digits is variable (for example, 
Internet Explorer [IE] uses 9, and Word uses 10). 

Finally, if you place only CF_HTML on the clipboard, applica- 
tions such as Word and FrontPage don't know what to do with it. 
You must also supply a plain-text rendition of the stylized HTML 
to the clipboard for these apps to behave as expected. Scads of tools 
perform HTML-to-text conversions, or the extremely macho might 
prefer to roll their own parsers. But, no Windows programmer 
should ever have to hand-parse HTML again. You can call upon the 
OS instead for this everyday task: 

Public Function Html 2Text(ByVal Data 
As String) As String 
Dim obj As Object 
On Error Resume Next 
Set obj = _ 

CreateObjectChtmlfile") 
obj . Open 
obj .Write Data 

Html2Text = obj . Body . InnerText 
End Function 

Leveraging IE isn't necessarily the quickest method for parsing 
HTML, but the expediency it offers is a good tradeoff in this case. 
— K.RP. 



Juval Lowy is a software architect and the principal of IDesign, a 
consulting and training company focused on .NET design and .NET 
migration. Juval is a Microsoft regional director for the Silicon Valley, 
working with Microsoft on helping the industry adopt .NET. His latest 
book is Programming .NET Components (O'Reilly & Associates). 
Contact him at www.idesign.net. 

Karl E. Peterson is a GIS analyst with a regional transportation 
planning agency and serves as a member of the VSM Editorial 
Advisory Board. Online, he's a Microsoft MVP and a section leader on 
several DevX forums. Find more of Karl's VB samples at www.mvps. 
org/vb. Reach him at karl@mvps.org. 



Additional Resources 

• "H0WT0: Add HTML Code to the Clipboard by Using Visual 
Basic": http://support.microsott.com/detault.aspx?scid=kb; 
us;q274326 



"HTML Clipboard Format" 
orkshop/networking/clipb 



http://rnsdn.rnicrosoft.com/ 
,arH/f 
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Relational 
database 



Object-oriented 
development 




If your back-end database isn't a good match for 
your front-end development, you need a new database. 
Cache, the post-relational database from InterSystems, 
is a powerful fusion of today's mainstream technologies: 
objects and SQL. 

Unlike Oracle and other relational databases, 
Cache takes advantage of its efficient multi-dimensional 
data engine to implement an advanced object model. 
It doesn't try to hide a cumbersome relational engine 
beneath object-like wrappers. 



Every Cache object is compatible with Java, C++, 
ActiveX, and other rapid development technologies. And 
thanks to Cache's "Unified Data Architecture," every object 
class is instantly accessible as tables via ODBC and JDBC. 

With no mapping or middleware. That means no wasted 
development time. And no extra processing at run time. 
So not only will your applications be quick to build or 
adapt, they will run faster too. 

Cache is available for Windows, OpenVMS, Linux and 
major Unix systems. 



Don't Let Your Database 
Slow You Down. 

InterSystems f 

C CACHE 

Make Applications Faster 

Download a fully-functional version of Cache or request it on CD for free at www.lnterSystems.com/ matchl 



(9 2002 InterSystems Corporator M nghts reserved InterSystems Cache is a registered trademark of IrrterSysiems Corporation. 



Separate Form, 
Function, and Style 



Take advantage of VS.NET's support for XML technologies to make your Web apps 
more versatile and easier to modify. 



Technology Toolbox 

a' VB.NET 

B'C* 

□ SQL Server 2000 
a' ASP.NET 
SfXML 

□ VB6 

Go Online! 



Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these resources. 

Download 

VS0302AN Download the code for 
this article, which includes an 
ASP.NET application that demon- 
strates how to combine XML, XSLT, 
and CSS to make flexible and 
responsive Web applications. 

Discuss 

VS0302AN D Discuss this article in 
theASP.NET forum. 

Read More 

VS0302AN_T Read this article 
online. It includes the sidebar, 
"Reduce Separation Anxiety With 
XML," that describes four important 
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Feb developers now have the tools to 
separate Web pages' content, structure, 
and formatting, letring you use each one more 
effectively and plug in new features and changes 
easily. XML holds the content and provides the 
means to transform it into various forms of 
HTML with Extensible Stylesheet Language 
Transformations (XSLT) . Cascading Style Sheets 
(CSS) make it pretty. 

The Visual Studio .NET IDE includes built- 
in support for creating and modifying content 
using these technologies, and it gets them to work 
together well. I'll explore this support and show 
how you can integrate styles into your 
applications. I assume you know each 
technology's basics — which aren't diffi- 
cult to learn — and how to apply them 
(download the sidebar, "Reduce Separa- 
tion Anxiety With XML," from the VSM 
Web site; see the Go Online box for de- 
tails). I'll focus on the tools for using CSS 
to display XML after XSLT transforms it. 

I'll use a simple transformation ofXML 
content from two sources to demonstrate 
working with CSS in an ASP.NET app. 
The first source is a disk file with apizzeria's 
customer information (see Listing 1). The 
second is a historical record of each 
customer's pizza orders (see Listing 2). An 
important technique XSLT provides for 
flexible Web applications is the ability to 
combine multiple sources of XML data 
into a single output stream. XSLT uses the 
XSLT document() function to combine 
the two files (see Listing 3). 

The document() function returns the 
contents of the second set of XML data as 
a node set — essentially, as a branch of the 
XML data hierarchy. The <xsl:variable> 
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element's select attribute loads the XML data and 
applies an XPath query to filter the node set: 

<xsl :variable name="CustomerLookup" 
se'l ect=" document { 'Pizza 
Customers .xml ' ) 

/Customers /Customer [©Customer I D= 
current( )/@CustomerID]"/> 

Internet Explorer displays the transformation's 
results (see Figure 1). 

The downloadable sample project's XML- 
CSSXSLT.aspx page uses a <link> element in 
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Using CSS in VS.NET 

<~ Default Styles 
C Fancy Styles 
r No Styles 

Orders by Date 
Barbara Morris 

1313 Mockingbird Lane 
Seattle, WA 98117 



J 



[Order Date Delivery Date Salesperson ! 


;10/08/2002 


10/08/2002 Charette. Paula j 


ilO/26/2002 


10/27/2002 |Doe,John 


10/28/2002 10/28/2002 Krash Steve 1 



Figure 1 Transform XML Into Formatted XHTML. The 

sample application combines multiple XML data sets, 
uses XSLT to transform the XM L into XHTM L, then uses 
CSS to format it for display. When you separate content, 
structure, and formatting this way, making site-wide 
changes becomes almost trivial, and creating robust ap- 
plications usable on multiple devices is well within reach. 
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the page's head section to declare to the user agent (the browser) that 
it should use the Styles. ess file for formatting. Styles are applied by 

f XML • Record Customer Data in XML ^ 



<?xml version="l . 0"?> 
<Customers> 

<Customer CustomerID="l"> 

<LastName>Morris</LastName> 

<FirstName>Barbaca</FirstName> 

<Address>1313 Mockingbird Lane</Address> 

<City>Seattle</City> 

<State>WA</State> 

<ZipCode>98117</ZipCode> 

<Phone>2069367030</Phone> 

<Ema_ul08 ?>someone@el se . com</Ema„ul08 ?> 

<Notes>Hello</Notes> 
</Customer> 

</Customers> 

Listing 1 The Pizza Customers. xml file consists of customer infor- 
mation. The sample application combines it with pizza-order informa- 
tion in the transformation to produce the full Web page. 



XML • Link Orders Data to Customer Data 



<?xml versi on="l . 0"?> 
<OrdersByCustomer> 

<Customer CustomerID="l"> 
<LastNarne>Morris</LastName> 
<FirstName>Barbara</FirstName> 
<0rder 0rderID="2174"> 
<Sa 1 esperson>Charette , 
Paula</Salesperson> 
<0rderDate>2002/10/08</0rderDate> 
<Del iveryDate>2002/10/08</Del i veryDate> 
<Del i veryTime>00 : 16</Del i veryTime> 
<OrderDetai 1 s> 
<Item ItemID="l"> 
<MenuID>3</MenuID> 
<ItemDescription> 

Large Coke 
</ ItemDescri pti on> 
<Unit>Cup</Unit> 
<SalePrice>0.8663</SalePrice> 
<Quantity>3</Quantity> 
</Item> 

<Item ItemID="2"> 
<MenuID>2</MenuID> 
<ItemDescri pti on> 

Large Pepperoni Pizza 
</ ItemDescri pti on> 
<Unit>Pie</Unit> 
<SalePrice>14.7609</SalePrice> 
<Quanti ty>4</Quanti ty> 
</Item> 
</OrderDetails> 
</0rder> 

</Customer> 

</OrdersByCustomer> 

Listing 2 The Pizza Orders.xml file contains information about each 
customer's orders over a recent time period. Notice that the link be- 
tween this XML and the XML in the customer file in Listing 1 is the 
<Customer> element's CustomerlD attribute in both files. This works 
like a primary-key/foreign-key relationship in a relational database. 



the user agent — not on the server — long after all server-side process- 
ing is complete. 

You must understand the steps that occur in this kind of Web 
page in order to make effective use of the separation of content, 
structure, and formatting. First, a user makes an HTTP request for 
a page. Then, ASP.NET loads and processes the ASPX file, convert- 
ing server controls to Extensible HTML (XHTML) and running 
server-side code. Next, the browser receives the XHTML. The 
browser requests the stylesheet file from the server if the page uses 
a <link> element. 

The next step depends on the type of styles the page uses. If it uses 
an external stylesheet, the browser checks each element to see if it 
matches a rule in the external stylesheet. If it uses page styles, the 
browser checks to see if each element matches a stylesheet rule. An 
inline rule found in the XHTML overrides any conflicting rule in 
an external stylesheet. If the page uses inline styles, the browser uses 
information in style attributes to render elements. 

TheASP.NET XML Web server control provides an easy way to 
transform XML and show the result. You use this control's simple 
interface to load and parse both the source XML and the XSLT 
template, then display the result. You can do everything program- 
matically at run time or set properties at design time. The sample 
project assigns the primary XML source file — Pizza Orders.xml — 
to the DocumentSource property, and the XSLT file to the 
TransformSource property. XSLT transformations don't get any 
easier than this. 

Output Goes to the Browser 

Internet Information Services (IIS) sends the output stream to the 
browser after the XML server control transforms the XML source 

XSLT • Combine and Transform \ 

<xsl :template match="Customer"> 

<xsl :variable name="CustomerLookup" 
select="document('Pizza Customers . xml ' ) 
/Cus tome r s /Customer [©Customer I D=curr en t( ) 
/@CustomerID]"/> 

<h2> 

<xs1 : val ue-of sel ect="Fi rstName"/> 

<xsl:text> </xsl:text> 

<xsl :value-of sel ect=" LastName" /> 

</h2> 

<xsl :for-each sel ect="$CustomerLookup"> 
<xsl:value-of sel ec t=" Ad dress "/> 

<br/> - 

<xsl : val ue-of sel ect="Ci ty" /> 
<xsl :text>, </xsl :text> 
<xsl : val ue-of sel ect="State"/> 
<xsl:text> </xsl:text> 
<xsl : val ue-of sel ect="Zi pCode"/> 
<br/> 
</xsl :for-each> 



Listing 3 CustOrders.xsl transforms the XML files in Listings 1 and 2 
into a single set of XHTML that ASP.NET sends back to the user agent. 
This snippet is the first part of the template rule that matches the 
<Customer> element. Note how the CustomerLookup variable uses 
the XSLT document!) function to load the second set of XML content 
from a file. (Line breaks are made to fit the magazine column.) 
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font-size: le»; 
font -weight: bold; 
word-spacing: normal; 
letter-spacing: normal; 
text- transform: none; 
font-family: Arial, Helvetica, 
} 



A: link { 

text-decoration: 
color: #3333cc; 
} 



text-decoration: 
color: #333399; 
> 

Aiactive { 

tex t- de c or ati on: 
color: #333399; 
} 

A: hover { 

text-decoration: 
color: #3333cc; 



sans-serif; 




Figure 2 Edit External Stylesheets. VS. NET'S built-in CSS editor provides an easy way to 
create styles. The left pane is the Document Outline window (you can open it from the View 
menu when a CSS stylesheet is loaded), and the right pane is the CSS editor. You can edit the 
CSS text directly in the editor, or use the visual Style Builder. 



files into HTML. However, the browser isn't done processing the 
page's contents, because the page contains a <link> element with a 
CSS stylesheet. Here's the CSS stylesheet declaration from the 
ASPX page: 

<link i d="l 1 nkStyl es" 

href=" Styles/Styles. ess" 

type=" text /ess" rel=" stylesheet" 

runat-"server" /> 



he ASP.NET XML Web 
rver control provides an 
asy way to transform 

ow the result 

One of the many nice things you can do with ASP.NET is 
modify the page's behavior on the fly. The <link> element in the 
previous code includes the runat=" server" attribute. This allows 
server-side code to change the stylesheet used to render the XHTML, 
changing the <link> element's href attribute on the fly. This code is 
within a Select Case based on which radio button the user selects: 

linkStyles. Attributes. Itemt "href " ) = 
"Styles/Customi zed .ess" 

This is a great technique for changing a page's appearance dynami- 
cally — in this case, in response to a user selection. (It causes a 



postback in the sample application, but 
there are ways to get around that if you want 
processing to stay on the client.) 

VS.NET includes a variety of tools for 
creating CSS styles and associating them with 
XHTML code (see Table 1). You can find 
them in many right-click popup menus 
throughout the IDE and on various menu 
items. If you're into writing raw HTML, of 
course, you can always add CSS features 
directly in the VS.NET HTML editor. 

Most of the time, you use external 
stylesheets in production Web applications, 
because you can make a site consistent across 
all pages by defining styles in a central 
location and applying them everywhere. 
VS.NET provides a good starting point 
with a Styles.css file it adds to every new 
regular and enterprise VB.NET Web appli- 
cation. (C# equivalents to these projects 
don't include Styles.css, but you can modify 
the templates to include it.) 

Although the VB.NET projects include 
Styles.css, you still must use the <link ele- 
ment to add a declaration to it explicitly in 
every page. If you find yourself doing this in 
every new project, you can modify both the ASPX and Styles.css 
templates in subdirectories of c:\Program Files\Microsoft Visual 
Studio .NET. Any changes you make to these templates apply to 
each new project you create. 

VS.NET includes a nice external CSS stylesheet editor that 
opens whenever you load a CSS file into the IDE (see Figure 2) . The 





Figure 3 Build Styles Visually. The VS.NET Style Builder provides a 
simple way to create and edit CSS styles. By selecting different cat- 
egories of formatting, you don't even have to remember the syntax 
for a style. When you finish, the Builder adds a style attribute for 
inline styles, creates a new page style, or adds the style to an exter- 
nal stylesheet, depending on where you invoked the tool. 
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Style Type 


Tool 


Inline styles 


• Style Builder 




• HTML Editor 


Page styles 


• Document Styles Window, with Add Style Rule Editor and Style Builder 




• HTML Editor 


External styles 


• Document Styles Window, with Add Style Link 




• CSS Editor, with Add Style Rule Editor and Style Builder 




• Edit stylesheet directly as text 



Table 1 Create and Apply CSS Styles. VS.NET has several tools that help you create and 
apply Cascading Style Sheet (CSS) styles to ASP.NET pages. The visual tools are handy if 
you're new to CSS; or you can edit the styles directly with a built-in text editor if you know 
CSS well. 



Property Applies To 



Description 



class 



HTML elements 



CssClass ASP.NET Web server controls 



style Most individual HTML and 

ASP.NET Web server controls 



Adds the class attribute to the selected 
element. 

Adds the CssClass attribute to the control, 
which generates a class attribute for the 
resulting HTML element at run time. 

If set from the VS.NET Properties window, 
uses the Style Builder to construct a style 
attribute for the element. Add the style 
attribute directly in the HTML editor. 



Table 2 Use Object Properties to Apply Styles. Web pages you create with ASP.NET and 
VS.NET give you plenty of ways to apply styles to HTML. Some of the properties modify HTML 
attributes of both HTML and ASP.NET server controls, while others apply to one or the other. 



editor makes it easy to select and edit an 
individual style. Right-clicking on a style 
definition in either pane lets you load the 
Style Builder tool (see Figure 3). 

Creating a new style is simple with the 
Add Style Rule dialog. It lets you select an 
HTML element to apply globally to all the 
element's instances in the page, a class name 
to apply to multiple element types, or an 
element ID for styling. An often overlooked 
feature of this tool is the ability to select 
multiple items — for example, to apply a 
style to all <p> elements of class Emphasis, 
or only to <li> elements that are children of 
an <ul> that's a child of a <p> element. 

You might need to apply styles you cre- 
ate to various elements explicitly — a re- 
quirement that applies mainly to inline ele- 
ments. VS.NET provides a few object prop- 
erties for assigning styles (see Table 2). One 
downside to using these properties is that 
the VS.NET Properties window doesn't 
display a list to let you select a style or class, 
and it doesn't include a link to fire up the 
Style Builder, so you must type in the style 
or class manually. 

Using CSS stylesheets with XML and 



XSLT transformations is the key to making 
your Web applications flexible, dynamic, 
and functional. Take advantage of the tools 
VS NET has for incorporating CSS into your 
applications. All these technologies enable 
you to make Web applications usable on a 
multitude of devices if you take the time to 
design and implement them properly. VSM 

Don Kiely is a senior information architect for 
Information Insights, a business and technol- 
ogy consultancy in Fairbanks, Alaska. When 
he isn't living and breathing ASP.NET and 
XML, he's exploring the Alaskan wilderness 
with his dog Mardy, hiking, Whitewater 
kayaking, skiing, and geocaching. Reach him 
at donkiely@computer.org. 

Additional Resources 

• W3C's Architectural Principles of 
the World Wide Web working draft: 
www. w3. o rg/tr/we b a rc h/ 

• W3C's Web Style Sheets page: 
www.w3.org/style/ 

■XML training at AppDev 
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XML is a trademark of MIT. FREE XML S Web 
Services Magazine subscriptions available to 
qualified, IT professionals within the U.S. 
Publisher reserves the right to determine 
qualification. Please inquire for other 
subscription rates. 
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Boost Performance 
With a DataRelation 



Use a DataRelation's validation and navigation functionality to improve application 
efficiency and decrease development time. 




^ VB.NET 

□ c# 

SQL Server 2000 

□ ASP.NET 

□ XML 

□ VB6 
Note: 

Prerequisite: a basic understand- 
ing of ADO. NET and DataSets 



Go Online! 

Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these resources. 

Download 

VS0302DD Download the code for 
this article, which creates a 
DataRelation on columns in the 
Northwind sample SQL Server 
database's Orders and Order 
Details tables. 

Discuss 

VS0302DD_D Discuss this article in 
the SQL Server forum. 

Read More 

VS0302DD_T Read this article 
online. It includes Listing 2. 

VS0206DD_T Database Design, 
"Create More Efficient Database 
Code," by Dino Esposito 

VS0208DD_T Database Design, 
"Save Database Trips," by Bill 
Wagner 



he DataRelation class is one of many 
ADO.NET classes that both increase appli- 
cation performance and reduce development 
time. It improves your apps' speed by perform- 
ing client-side data-integrity validations. You 
cut development time by using the Data- 
Relation's navigation functionality, which re- 
duces the need to write custom code to navigate 
data between related DataTables. I'll describe a 
DataRelation and show how you can take ad- 
vantage of this class's capabilities to improve 
your applications. 

A DataRelation represents a parent/child re- 
lationship between two DataTable objects, simi- 
lar to a primary-key/ foreign-key relationship be- 
tween two SQL Server tables. You use a Data- 
Relation to enforce integrity-constraint rules, 
cascade data changes, and navigate data be- 
tween the related DataTables. The Data- 
Relation works on the client side, so you can 
decrease the network round trips your appli- 
cation makes by selecting all parent and child 
data in one call to the database. This elimi- 
nates the need to query the database for new 
child rows every time it selects a new parent 
row. A DataRelation relates two DataTable 
objects to each other through matching Data- 
Columns. You access DataRelation objects 
through a DataSet's Relations property or a 
DataTable's ChildRelations and Parent- 
Relations properties. These properties are 
DataRelationCollection objects. A Data- 
RelationCollection object is a collection of 
DataRelation objects. 

You create a DataRelation using either 
the DataRelationCoIlection's Add method 
or the DataRelation's constructor. Both 
methods are overloaded, which provides 



by Paul Delcogliano 

plenty of flexibility when you create a Data- 
Relation. The sample application lets you see 
how different objects and property settings af- 
fect the DataRelation's behavior (download the 
sample code from the VSM Web site; see the Go 
Online box for details). The sample code creates 
a DataRelation on the OrderlD columns of the 
Orders and Order Details tables in the North- 
wind sample SQL Server database: 

Dim rel OrderToOrderDetai 1 As _ 
DataRel at i on 

' Create the relationship between the 
' Orders and Order Details DataTables 
rel OrderToOrderDetai 1 = New 

DataRel ati on ( 0RDERS_T0_DETAI LS_FK , 



Member Name Description 



Cascade 


Deletes or updates related rows. 




This is the default. 


None 


Takes no action on related rows. 


SetDefault 


Sets values in related rows to 




the value contained in the 




DefaultValue property. 


SetNull 


Sets values in related rows to 
DBNull. 



Table 1 Set Constraint Property Values. The pos- 
sible values for a ForeignKeyConstraint object's Up- 
dateRule and DeleteRule properties are Cascade, 
None, SetDefault, and SetNull. Cascade specifies that 
all related child DataTable rows will be deleted when 
the parent row is deleted. None specifies that no 
action will occur, but exceptions will be thrown. Set- 
Default sets the default value for the column, and 
SetNull sets all child column values to null. 
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Error trying to delete 




Figure 1 DataRelation Throws an Exception. When you set EnforceConstraints to True, the DataRelation throws an exception when any 
data or operation violates a constraint rule. The validation occurs on the client, without any communication with the database. 



Error trying to delete 



□ 



DELETE statement conflicted with COLUMN REFERENCE constraint 'FK_Order_Details_Orders'. The conflict occurred in database 'Northwind', table 'Order 
Details', column 'Order ID', 







OK 







Figure 2 SQL Server Enforces Constraint Rules. When you set EnforceConstraints to False, SQL Server enforces constraint rules and 
returns an error message when it encounters data that violates a constraint. 



dsDa ta. Tables (ORDERS). Co lumns( 
"OrderlD"), dsData .Tab! es( 
DETAILS) .Col umns( "OrderlD" ) , True) 

' Add the relationship to the dataset's 
' Relation property 

dsData. Relations. Add ( rel OrderToOrderDetai 1 ) 

The method signature the sample code uses takes a relationship 
name, parent column, child column, and Boolean parameters. You 
use the RelationshipName parameter to assign a unique name to the 
relationship. The parent and child column parameters tell the 
DataRelation which columns are involved in the relationship. The 
DataColumns can have different names, but they must be the same 
data type; otherwise, a DataException will be thrown. The Boolean 
parameter — CreateConstraints — tells the relationship whether it 
should create Constraint objects for this relation. A Constraint is a 
client-side rule that determines the course of action to take when the 
user or the app edits the data. The Add method creates two 
Constraint objects when CreateConstraints is True (the default): a 
UniqueConstraint and a ForeignKeyConstraint. You apply Con- 
straints to the columns in the relationship and access them through 
the DataTable's Constraints property. The DataRelation that the 
sample code uses creates a UniqueConstraint on the Order table's 
OrderlD column, and a ForeignKeyConstraint on the Order 
Details table's OrderlD column. 

Ensure Uniqueness 

The UniqueConstraint is a rule specifying that all values in the 
parent DataTable's primary-key column must be unique. Ensure 
uniqueness in the OrderlD column by specifying that the OrderlD 
value should increment automatically: 

With dsRet urn .Tabl es( ORDERS) .Col umns( "OrderlD" ) 

Autolncrement = True 

AutoIncrementSeed = 

AutoIncrementStep = -1 
End With 



VB.NET • Set the Delete Rule 



Private Sub 

cboDeleteRule_SelectedIndexChanged(ByVal _ 
sender As Object. ByVal e As 
System. EventArgs ) Handles _ 
cboDel eteRul e.Sel ectedlndexChanged 

' Check for the existence of the constraint 
' before setting the delete rule. 
If _dsNorthwi ndData .Tabl es( _ 
_i OrderDetai IsTablelndexhConstraints. 
Contains(_oData.OrderToDetailsFK) Then 
CType(_dsNorthwi ndData. Tables( 
_i OrderDetai 1 sTabl elndex) . 
Constraints(O) , _ 
Forei gnKeyConstrai nt ). Del eteRul e = 
GetRul eFromSel ecti on ( 
cboDel eteRul e.Selectedlnd ex) 
End If 

End Sub 

Private Function GetRul eFromSel ecti on( ByVal _ 
iSelectedlndex As Intl6) As Rule 

Select Case iSelectedlndex 

Case ' cascade 

Return Rule. Cascade 
Case 1 ' none 

Return Rule. None 
Case 2 ' default 

Return Rule.SetDefault 
Case 3 ' null 

Return Rule.SetNull 

End Select 
End Function 



Listing 1 This code sets the delete rule when you change the value 
in the Delete Rule dropdown control. Changing the DeleteRule prop- 
erty value affects how child rows are handled when a parent row is 
deleted. Setting the DeleteRule to None throws an exception when 
you set the EnforceConstraints property to True. 
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Use three DataColumn properties — Autolncrement, Autolncre- 
mentSeed, and AutoIncrementStep — to set up a column to auto- 
increment. The Autolncrement property is a Boolean that, when you 
set it to True, tells the column it'll generate new OrderlD values for 
each new Order record added to the DataTable. AutoIncrementSeed 
is the starting value, and AutoIncrementStep is the value by which to 
increase the new OrderlD value for each row. Notice that the code 
specifies an AutoIncrementStep of - 1 . Using - 1 ensures that any new 
generated values don't conflict with existing OrderlD values. 



fry adding a 
DataRelation to your 
application the next 
time you work on a 
project that requires 
data from more than 
one related DataTable. 



A ForeignKeyConstraint can restrict, as well as cascade, changes 
to related columns based on its two rule properties: DeleteRule and 
UpdateRule. Both rules define an action to perform on child data 
when changes are made to parent data. You use the DeleteRule to 
specify what action should take place when a row from the parent 
DataTable is deleted. The UpdateRule determines what should 
happen when a parent's key value is updated (see Table 1 ). Cascade 
is the default rule value. Updates and deletes cascade down from the 
parent row to the related child rows. You use a ForeignKeyConstraint 
when the parent column in the relationship is a primary-key 
column. If you enforce constraint rules, any data that violates either 
the UniqueConstraint or the ForeignKeyConstraint will throw a 
ConstraintException. 

By default, Constraints you create through the DataRelation are 
enforced on the client. Sometimes you might not want to enforce the 
Constraints, such as when you add a relationship to data that you 
know violates a constraint rule. In these situations, you set the 
DataSet's EnforceConstraints property to False. EnforceConstraints 
affects both Constraints in the relationship. When it's set to False, 
changes to data in a DataTable aren't validated against the constraint 
rules. Setting EnforceConstraints to False turns off only client-side 
constraint restrictions. The database server still throws an error when 
you try to save data that violates one of its constraint rules. 

To see this behavior in action, run the sample application, set the 
delete rule to none, make sure the Enforce Constraints checkbox is 
checked, and click on the Delete Order button. When Enforce- 
Constraints is checked, the DataRelation provides an immediate 
client-side error when you try to delete a parent row without 



deleting its related child rows (see Figure 1). Next, uncheck the 
EnforceConstraints checkbox and click on the Delete Order button 
again. This time you'll notice that you get a SQL Server error 
message from the database server describing a constraint validation 
(see Figure 2 and Listing 1). 

Bind With DataRelations 

Enhancing performance is a great reason to use a DataRelation, but 
it's not the only reason. A DataRelation can also decrease your 
development time through its navigation capabilities. You can use 
it to find related data between DataTables easily, and you can bind 
to a relation in a WinForms application, which frees you from 
writing custom navigation code and lets you focus on the application's 
business rules. 

Use a DataRow's GetChildRows and GetParentRow methods 
to find data quickly through a DataRelation. Both methods take 
DataRelations as a parameter and return related rows. Call the 
GetChildRows method from the parent row to find all the child 
rows for a particular parent row. GetChildRows returns an array of 
DataRow objects: 

Dim oChildRows As DataRowO = _ 
_dsNorthwi ndData .Tab! est _ 

_iOrderTableIndex) . Rows (_bmbOrders . Posi tion) . _ 
Get Chi 1 dRows (_oDa ta .OrderToDetailsFK) 

Using these methods eliminates the need for custom code that 
filters records from the child DataTable based on the current parent 
row OrderlD. WinForms databinding also supports binding to a 
DataRelation. Bind data from the Orders DataTable to controls on 
the form, then bind a DataGrid to the DataRelation (download 
Listing 2). Once the controls are bound, changing an Order record 
by selecting an OrderlD from the form's treeview control refreshes 
the related child data in the DataGrid automatically to reflect the 
changed parent record. When you look at the two methods, you can 
see how much less code you need when you bind to a DataRelation. 

DataRelations provide functionality beyond that of the standard 
DataSetand DataTableADO.NET objects. Their ability to enforce 
constraints rules and their built-in navigation capability make 
working with related data a snap. Try adding a DataRelation to your 
application the next time you work on a project that requires data 
from more than one related DataTable. You'll appreciate the 
benefits immediately, wsm 

Paul Delcogliano is the director of technology at Progressive Sys- 
tems Consulting, where he has been developing Windows and Web- 
based applications with Visual Studio .NET since beta 1 . When he's 
not writing articles or working on a project, you can find him playing 
hockey. Contact Paul at pdelco@progsys.com. 



Additional Resources 

• Microsoft .NET Framework SDK documentation 

• "Data Binding Between Controls in Windows Forms" 
Esposito [MSDN Magazine February 2002]: http:// 
msdn.microsoft.com/msdnmag/issues/02/02/cutting/ 
cutting0202.asp 
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COM is Key to 
VB.NET Success 



Ever since VB.NET appeared on the scene — even before the 
first beta version was released — the VB developer commu- 
nity has focused on learning and implementing this new 
technology and all the other .NET technologies associated with 
it, such as Web services, ADO.NET, and the .NET Framework. 
You must master them to provide the best customer service to 
your clients, be they external companies or corporate depart- 
ments. You also must learn them to maintain your marketability, 
which often hinges on whether you know software tools' latest 
versions. Knowing how to build new applications with VB.NET 
is important, but the key to success as a VB.NET developer lies 
in learning how to get VB.NET to work with existing VB appli- 
cations — with COM in particular. 

If a company has been in business for a reasonable length of 
time and uses Windows-based custom software, the likelihood is 
high that its applications are based on COM. COM has been 
around since the early 1990s, giving companies ample time to in- 
vest in the technology. Software infrastructure doesn't change 
overnight, regardless of the benefits the .NET languages and ob- 
ject models provide. The sheer volume of business logic and code 
in exisring COM components causes companies to move slowly 
to any new technology. Most companies are adopting .NET at a 
slow pace for several reasons. Perhaps they want to make sure it's 
not just another technology dujour. Many are hesitating for fi- 
nancial reasons as they balance .NET's benefits with its imple- 
mentation costs. 

The prevalence of existing COM components in combination 
with companies' slow migration to .NET means that a large con- 
tingent of developers must know when and how to integrate the 
two technologies and understand the benefits and pitfalls of do- 
ing so. 

.NET components and COM components aren't naturally 
compatible, because their internal architectures are vastly differ- 
ent. For this reason, the .NET Framework's interoperability fea- 
tures let your .NET apps use COM components. .NET provides 
three types of interoperability with unmanaged code: the ability 
to call a COM component from .NET, the ability to call a .NET 
component from COM, and the ability to call API functions 
from .NET. When you call unmanaged COM components from 
.NET, the runtime creates a proxy component for the COM ob- 
ject called a runtime callable wrapper (RCW)- The RCW 
handles all the intetaction between .NET code and the COM 
component. When you call .NET components from COM, the 
runtime creates a proxy called a COM callable wrapper (CCW)- 



.NET uses Platform Invocation 
to allow .NET code to make calls 
to APIs, such as calls to the Win- 
dows operating system's API 
functions. 

If you can reuse existing com- 
ponents in your .NET applica- 
tions without making many 
changes to them, you have a 
good case for preserving an in- 
vestment in COM. You must 
also know when it makes better 
sense to migrate unmanaged 
COM code to .NET. For ex- 
ample, the interoperability com- 
ponents involved in calling 
unmanaged code from .NET 
have some overhead that might 
create a performance hit, depend- 
ing on your implementation. An- 
other drawback of interoperating 




Discuss this opinion in the 
Talk to the Editors of Visual 
Studio Magazine forum on 
our Web site. Use this Loca- 
tor code VS0302GCLD 

The opinions expressed 
in this editorial are those of 
the author and not neces- 
sarily the opinions of VSM. 
i ^a w , MW W .. n tW M ^ww™.. a m 



is that you can't take advantage 
of certain .NET features when you work with unmanaged COM 
components, which makes them more difficult to use in the de- 
velopment environment. Deciding which direction to take re- 
quires a careful cost/benefit analysis. 

If you haven't moved into the .NET world yet and are still 
writing VB6 components, you can prepare now for the possibil- 
ity that calls to those COM components will eventually come 
from managed code. For example, some of rhe unmanaged data 
types map directly to managed data types, whereas other 
unmanaged data rypes require translation by the RCW and are 
less efficient. Other issues to keep in mind include the way man- 
aged code handles the fact that VB6 defaults to passing param- 
eters by reference instead of by value; the fact that type libraries 
are optional in VB unmanaged code, but type information is re- 
quired in managed code; and VB6's support for optional param- 
eters and defaults for those optional parameters, vsm 

Dianne Siebold is the director of business analysis for a software 
company in San Diego and a programmer specializing in VB and SQL 
Server. She's a regular contributor to VSM and the author of Visual 
Basic Developer's Guide to SQL Server (Sybex). Reach her at 
dsiebold@earthlink.net. 
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With Wise things are so good I just bought my 
wife a new car! Two experienced programmers spent 
almost a year trying to create installations using 
InstallShield®. Hundreds of customers were waiting 
for product to ship. Then I discovered Wise, and the 
effect was like a cloudburst after a drought!* 

Ernie Warner 

Managing Director, Warner Software 



*Unsolicited testimonial from satisfied Wise Solutions customer 



Read Ernie's full story at www.wise.com/thebest.asp. 
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Are your installation tools costing you precious 
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"We bought Wise and in one working day had an 
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Quickly, easily create reliable installations with the 
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Framework and XML Web services. 



